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

# Shared Chats

> Read the safe, read-only transcript for an organization or public chat.

Shared-chat access exposes a sanitized, read-only transcript. The route is under the standard API base URL at `/shared-chats`.

## Endpoint

| Method | Path                | Description                   | Auth             |
| ------ | ------------------- | ----------------------------- | ---------------- |
| `GET`  | `/shared-chats/:id` | Read a shared chat transcript | \[Optional User] |

## Read a shared chat

`GET /shared-chats/:id`

Authentication depends on the chat's access level:

| Access level | Behavior                                                          |
| ------------ | ----------------------------------------------------------------- |
| `private`    | Not available through the shared route; returns `404`.            |
| `org`        | Requires a signed-in user who belongs to the owning organization. |
| `public`     | Open without authentication.                                      |

```bash theme={null}
curl "https://api.autosage.ai/api/v1/shared-chats/CHAT_ID"
```

For an organization-only chat, send the signed-in user's session with the request.

### Response shape

The response contains chat metadata and `messages`:

```json theme={null}
{
  "chat": {
    "id": "CHAT_ID",
    "title": "Returns policy",
    "knowledgeBaseId": "KB_ID",
    "knowledgeBaseName": "Support docs",
    "accessLevel": "public",
    "transcriptTruncated": false
  },
  "messages": [
    {
      "role": "user",
      "content": "What is the return window?"
    },
    {
      "role": "assistant",
      "content": "Returns are accepted within 30 days.",
      "metadata": {
        "sources": [],
        "memoryUsed": false,
        "delegatedAgentIds": [],
        "imageUrls": []
      }
    }
  ]
}
```

Only `user` and `assistant` messages are included. Message metadata is reduced to the share-safe `sources`, `memoryUsed`, `delegatedAgentIds`, and `imageUrls` fields when present. Private usage, credit, token, tool-history, and operational metadata are not exposed.

<Note>
  The shared response includes at most the 200 most recent messages. When older messages are omitted, `transcriptTruncated` is `true`.
</Note>

## Read-only behavior

This endpoint never modifies the source chat and does not provide a send-message operation. To continue a shared conversation, create a new private chat using `shared_source_chat_id` on `POST /chats`; AutoSage seeds it from up to the 120 most recent share-safe user and assistant messages.

<Warning>
  Public links can be opened by anyone who has the URL. Change the source chat back to `private` to make the shared endpoint unavailable.
</Warning>

## Next steps

<CardGroup cols={2}>
  <Card title="Chat sharing" icon="share-nodes" href="/chat/sharing">
    Learn how privacy levels and forking work.
  </Card>

  <Card title="Chats API" icon="comments" href="/developers/api/chats">
    Create a private fork or update access level.
  </Card>
</CardGroup>