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

# Chat Share API

> Create public links for conversations, manage access, and surface analytics.

Chat share routes let a signed-in user publish or revoke read-only views of a
conversation, similar to ChatGPT’s shareable links. Authenticated routes live
under `/api/v1/share`, while anonymous consumers access `/api/v1/public/share`.

### Quick facts

* Authenticated calls require an Auth0 Bearer token
* Share IDs are short, URL-safe identifiers generated via `nanoid`
* Public viewers are fingerprinted via IP + User-Agent to track `viewCount` and
  enforce continuation limits
* Expiration defaults to “never” but can be overridden per share (1–365 days)

| Capability    | Endpoint(s)                                                                                                          | Description                                                      |
| ------------- | -------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------- |
| Create        | [`POST /share`](./chat-share/create)                                                                                 | Mint a new share link for the given conversation                 |
| List          | [`GET /share/list`](./chat-share/list)                                                                               | Paginate through the caller’s active, expired, or revoked shares |
| Update        | [`PATCH /share/{shareId}`](./chat-share/update)                                                                      | Control continuation, expiration, and copy                       |
| Revoke        | [`DELETE /share/{shareId}`](./chat-share/revoke)                                                                     | Immediately disable a share                                      |
| Analytics     | [`GET /share/{shareId}/analytics`](./chat-share/analytics)                                                           | Inspect total views, unique viewers, and continuation counts     |
| Public access | [`GET /public/share/{shareId}`](./chat-share/view), [`POST /public/share/{shareId}/continue`](./chat-share/continue) | Consume a shared transcript or fork it into a new conversation   |

Check each endpoint page for request/response schemas, example payloads, and the
interactive OpenAPI console.