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

# Sharing

> Publish a read-only snapshot of a dashboard or a whole chat, and read shared content.

> [!TIP]
>
> **The easiest way: ask your AI assistant.** With [Itoflow MCP](https://docs.itoflow.ai/mcp/install.md) connected to Claude or Codex, paste:
>
> ```text theme={null}
> Use Itoflow to share the dashboard from my latest research chat and give me the
> public link. Tell me what the snapshot includes before you share it.
> ```
>
> > [card] [Open in Claude](https://claude.ai/new?q=Use%20the%20Itoflow%20plugin%20\(https%3A%2F%2Fgithub.com%2Fitoflow%2Fskills\)%20for%20this.%20If%20it%20isn't%20installed%20yet%2C%20first%20tell%20me%20how%20to%20install%20it%20and%20sign%20in%20to%20Itoflow%2C%20and%20wait%20until%20I%20confirm.%20Then%3A%0A%0AUse%20Itoflow%20to%20share%20the%20dashboard%20from%20my%20latest%20research%20chat%20and%20give%20me%20the%20public%20link.%20Tell%20me%20what%20the%20snapshot%20includes%20before%20you%20share%20it.)
> >
> > Start this in Claude with the Itoflow plugin.
>
> > [card] [Open in ChatGPT](https://chatgpt.com/?q=Use%20the%20Itoflow%20plugin%20\(https%3A%2F%2Fgithub.com%2Fitoflow%2Fskills\)%20for%20this.%20If%20it%20isn't%20installed%20yet%2C%20first%20tell%20me%20how%20to%20install%20it%20and%20sign%20in%20to%20Itoflow%2C%20and%20wait%20until%20I%20confirm.%20Then%3A%0A%0AUse%20Itoflow%20to%20share%20the%20dashboard%20from%20my%20latest%20research%20chat%20and%20give%20me%20the%20public%20link.%20Tell%20me%20what%20the%20snapshot%20includes%20before%20you%20share%20it.)
> >
> > Start this in ChatGPT with the Itoflow plugin.
>
> Using another client? Copy the prompt with the button on the code block.
>
> No tokens or code needed. You can also do this in the [Itoflow app](https://app.itoflow.ai/chat). The rest of this page covers the HTTP API.

You can share a single dashboard or a whole chat. Either way, Itoflow publishes a **snapshot**: a read-only copy that anyone with the link can open, without an account. Later changes to the chat don't appear in the snapshot. Check what it contains before you share it.

```mermaid theme={null}
flowchart LR
  Chat[Your private chat] --> Review[Choose what to share]
  Review --> Artifact[Public snapshot with a link]
```

## Share a dashboard

`POST /artifacts` with `chat_id` and a `source_locator` that identifies the dashboard. You can share a dashboard that was saved even if its run later failed. The response contains the `artifact` and its public `url`. It returns `201` when it creates a new snapshot, or `200` when it reuses an existing snapshot of the same dashboard.

Readers use `GET /artifacts/public/{slug}` and `GET /artifacts/public/{slug}/dataframes/{dfId}`. No token is needed.

`DELETE /artifacts/{slug}` takes the snapshot down. Copies someone already saved, or that a search engine cached, can't be recalled.

## Share a chat

`POST /chat-shares` publishes a read-only copy of a chat you own: its messages, working steps, dashboards, tool details and questions. It returns `201` when it creates a new snapshot, or `200` with your existing share when the chat hasn't changed since you last shared it. Readers use `GET /chat-shares/public/{slug}`, plus its `dataframes`, `plots` and `runtime-token` endpoints, which need no token. The runtime token only lets the page show the shared copy; it can't change the chat.

A shared chat shows that its files exist, but readers can't download them. A portfolio review in a shared message shows its rows as they were when you shared the chat; readers can't create the portfolio.

See the [sharing endpoint reference](https://docs.itoflow.ai/api-reference/coverage.md#sharing-and-data) for every field.


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