/Docs
Search docs or ask a question⌘K
DocsAgent
Changelog
API Reference Get a Shared Conversation

Get a Shared Conversation

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.
token:stringpathRequired
The share token from Share a Conversation.

Response — 200 OK

NameDescription
title:string
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.

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

StatusCodeWhen
404NOT_FOUNDAny of the cases above, or the project doesn't exist
500internal_errorThe conversation could not be loaded
Was this page helpful? Yes No
Request
bashJavaScriptPythonGoRubyPHPJavaC#bash
curl https://api.syntext.dev/v1/projects/3f2a9c1e-8b4d-4e7a-9c21-5d6e7f8a9b0c/chat/shared/q3V9xZk2Lm8RtYp0aBcD4eFgH5iJ6kLmN7oPqR8sT9u
Responseapplication/json
200OK
{
"data": {
"title": "Adding a custom domain",
"sharedAt": "2026-11-13T15:02:41.118Z",
"messages": [
{ "role": "user", "content": "How do I add a custom domain?" },
{ "role": "assistant", "content": "Add the domain under **Settings › Domains** [guides/custom-domains#Add a domain]…" }
]
}
}
Product
Resources
Company
© 2026 SyntextBuilt with Syntext