Read the transcript behind a conversation share link.
GET/v1/projects/{projectId}/chat/shared/{token}Try it
Returns the read-only transcript behind a share link. Your doc site's /ask/s/{token} page calls it and shows the conversation read-only, marked as shared by a reader. Public: the token is the only thing needed.
Note
On your doc site this endpoint is also served same-origin at GET /_chat/shared/{token}. The project comes from the site's hostname, so the path takes no projectId. A token that isn't 43 base64url characters gets 400 invalid_request before it reaches the API.
Path Parameters
NameDescription
projectId:stringpathRequired
The project ID. A token only works in the project it was created in.
The conversation's title, or Shared conversation when it has none.
sharedAt:string
When the snapshot was taken (ISO 8601). Only messages up to this moment are returned.
messages:array
Up to 100 messages, oldest first. Each has role (user or assistant) and content. A user message is only what the reader typed: an attached code block is left out. Answers keep their inline citations.
The response carries Cache-Control: private, no-store and X-Robots-Tag: noindex. On your doc site, the /ask/s/{token} page is also sent with Referrer-Policy: no-referrer, so the token never leaks to a link in the transcript, and with X-Robots-Tag: noindex, nofollow.
When a link stops working
The endpoint returns 404 — and the page shows This shared link no longer works — when:
•
the reader stopped sharing the conversation, or the token is unknown
•
the project turned sharing off (aiPersona.sharing: "off"): every link stops working, and works again if you turn it back on
•
the site went private — behind a password or SSO, or behind access control in password or invite-only mode
•
the snapshot contains an answer that used audience-gated content (checked again on every read)
Error Responses
Status
Code
When
404
NOT_FOUND
Any of the cases above, or the project doesn't exist