> ## Documentation Index
> Fetch the complete documentation index at: https://docs.oqoqo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Share results

> Publish a public link to a finished experiment, publish updates, unpublish it, or share it privately with a teammate.

Create a **public experiment link** to share results with customers, partners, or the community—no Oqoqo account required. A public link snapshots the experiment at publish time and updates only when you [publish an update](#publish-an-update). To share internally with teammates, [invite them to your organization](#share-privately-with-a-teammate) instead.

## What a public link shares

Public pages render **Matrix**, **Frictions**, **Runs**, and each run's **Traces**, **Output**, and **Evals**, alongside tasks, treatments, and Evals and Insights models (**Comparisons** is omitted).

| Shared publicly | Kept private |
| - | - |
| Runs, traces, and outputs | Machine variables and setup secrets |
| Evals verdicts and Insights findings | Files over 256 KiB and binary files |
| Text files up to 256 KiB | Project [tags](https://docs.oqoqo.ai/experiments/tags.md) |
| Frictions, fix targets, and concentration | **Suggested fix** and **What the agent did** |
| Custom public title and description | Organization name (unless **Show organization name** is checked) |

Before publishing, Oqoqo swaps internal IDs for public IDs and scrubs text resembling credentials (blocking publication if any potential secret remains). Public links are unlisted and ask search engines not to index them.

> [!WARNING]
>
> Anyone with a live public link can read and copy its results. Unpublishing disables the link immediately, though it cannot remove copies already saved elsewhere.

## Publish an experiment

You can publish one live public link per finished (**Completed** or **Needs review**) experiment.

> [tab] Dashboard
>
> 1. Open the experiment and select **Share**.
> 2. Enter a **Public title** (up to 120 characters) and optional **Description** (up to 2,000 characters).
> 3. Optionally enable **Show organization name** (off by default).
> 4. Review **What's shared**, confirm you understand what will become public, and select **Create public link**.
>
> Once **Building your public page…** completes, copy the link or select **View public page**.

> [tab] CLI
>
> ```bash theme={null}
> oqoqo experiments publish exp_8f2c41d0 --title "Skill lift" --description "Agents with and without our skill"
> ```
>
> Pass `--show-organization` to display your organization name ([`oqoqo experiments publish`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-publish)).

> [tab] Plugin (MCP)
>
> Ask your AI assistant to publish the experiment; it calls **Publish an experiment** ([`publish_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#publish_experiment)) after your approval.
>
> ```text theme={null}
> Publish experiment exp_8f2c41d0 with the title "Skill lift".
> ```

![Share experiment dialog with Public title, Description, Show organization name, What's shared, and Create public link.](https://mintcdn.com/oqoqo/YO1ysyUx4SPwBwoz/images/screenshots/share-dialog-light.png?fit=max\&auto=format\&n=YO1ysyUx4SPwBwoz\&q=85\&s=fe50bda5df9d48cae8b78276d22dee20)

The published title, description, and organization visibility remain locked to your choices even if you rename the experiment later. (If Insights are still clustering frictions, wait until grouping finishes before publishing.)

## Manage public links

Open **Organization settings → Public sharing** to search and manage every public link in your organization:

| Status | Meaning |
| - | - |
| **Publishing** / **Publishing update** | Build in progress (existing live pages remain accessible during updates) |
| **Live** | Public link is active (**New results available** notes when Evals or Insights ran since publishing) |
| **Publish failed** | Build failed; use **Publish update** or **Try again** from the row menu |
| **Unpublished** | Link disabled and files removed |

## Publish an update

When you rerun Evals or Insights on a published experiment, publish an update to refresh the existing link without breaking the URL (the previous snapshot stays live until the update builds).

> [tab] Dashboard
>
> Open **Organization settings → Public sharing**, open the experiment's actions menu, select **Publish update**, and confirm the update.

> [tab] CLI
>
> ```bash theme={null}
> oqoqo experiments publications update pub_5d1f9a27 --lock-version 3
> ```
>
> Read the current `--lock-version` from `oqoqo experiments publications get` (add `--yes` with `--output json` or outside a terminal) ([`oqoqo experiments publications update`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-publications-update)).

> [tab] Plugin (MCP)
>
> Ask your AI assistant to update the public link; it calls **Update a published experiment** ([`update_experiment_publication`](https://docs.oqoqo.ai/mcp-server/experiments#update_experiment_publication)) after your approval.

## Unpublish an experiment

Unpublishing disables the public link immediately and deletes its public files (republishing later generates a brand-new link). Unpublish any active public experiments before deleting a project.

> [tab] Dashboard
>
> Open **Organization settings → Public sharing**, open the experiment's actions menu, select **Unpublish**, and confirm.

> [tab] CLI
>
> ```bash theme={null}
> oqoqo experiments publications unpublish pub_5d1f9a27 --lock-version 3
> ```
>
> Add `--yes` with `--output json` or outside a terminal ([`oqoqo experiments publications unpublish`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-publications-unpublish)).

> [tab] Plugin (MCP)
>
> Ask your AI assistant to unpublish it; it calls **Unpublish an experiment** ([`unpublish_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#unpublish_experiment)) after your approval.

## List public experiments

> [tab] Dashboard
>
> Open **Organization settings → Public sharing**.

> [tab] CLI
>
> ```bash theme={null}
> oqoqo experiments publications list --status active
> oqoqo experiments publications get pub_5d1f9a27
> ```
>
> See [`oqoqo experiments publications list`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-publications-list).

> [tab] Plugin (MCP)
>
> Ask your AI assistant which experiments are public; it calls [`list_experiment_publications`](https://docs.oqoqo.ai/mcp-server/experiments#list_experiment_publications) or [`get_experiment_publication`](https://docs.oqoqo.ai/mcp-server/experiments#get_experiment_publication).

## Share privately with a teammate

Organization members can view every experiment directly. In **Share → Share privately with a teammate**, invite new teammates via [**Organization settings → Members**](https://docs.oqoqo.ai/setup/organization.md#invite-teammates) or select **Copy link** to send the private dashboard URL.

## From the CLI and the plugin

Anyone can read a public experiment's structured results without signing in using [`oqoqo gallery get`](https://docs.oqoqo.ai/cli/experiments#oqoqo-gallery-get) (`oqoqo gallery get pub_5d1f9a27 --section matrix`) or **Get results from a public link** ([`get_public_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#get_public_experiment)).

| Task | CLI | Plugin (MCP) |
| - | - | - |
| Publish an experiment | [`oqoqo experiments publish`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-publish) | [`publish_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#publish_experiment) |
| List or inspect public links | [`publications list`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-publications-list), [`get`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-publications-get) | [`list_experiment_publications`](https://docs.oqoqo.ai/mcp-server/experiments#list_experiment_publications), [`get_experiment_publication`](https://docs.oqoqo.ai/mcp-server/experiments#get_experiment_publication) |
| Update or unpublish a link | [`publications update`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-publications-update), [`unpublish`](https://docs.oqoqo.ai/cli/experiments#oqoqo-experiments-publications-unpublish) | [`update_experiment_publication`](https://docs.oqoqo.ai/mcp-server/experiments#update_experiment_publication), [`unpublish_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#unpublish_experiment) |
| Read public results without login | [`oqoqo gallery get`](https://docs.oqoqo.ai/cli/experiments#oqoqo-gallery-get) | [`get_public_experiment`](https://docs.oqoqo.ai/mcp-server/experiments#get_public_experiment) |

## Next steps

> [card] [Track results over time](https://docs.oqoqo.ai/guides/track-agents-over-time.md)
>
> Schedule recurring runs and compare trends.

> [card] [Schedules](https://docs.oqoqo.ai/experiments/schedules.md)
>
> Automate experiment launches on a cron cadence.

> [card] [Read results](https://docs.oqoqo.ai/evaluation/results.md)
>
> Inspect Matrix, Frictions, and Runs.

> [card] [oqoqo experiments](https://docs.oqoqo.ai/cli/experiments.md)
>
> Reference for publish and gallery CLI commands.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.