Conversation History
List, load, rename and delete a visitor's chat conversations for the agentic-mode ask page.
List a visitor's past chat conversations, load full transcripts, and rename or delete a conversation. These endpoints power the sidebar of the doc site's agentic mode (/ask page — available when the Agentic mode integration is enabled), where visitors can search, resume, replay, rename, and delete previous conversations.
All four endpoints are public (no API key required) but strictly scoped: a conversation is only returned or changed when it belongs to both the project and the requesting visitorId — one visitor can never read, rename, or delete another visitor's conversations.
On your doc site these endpoints are also served same-origin under /_chat/sessions (GET) and /_chat/sessions/{sessionId} (GET, PATCH, DELETE). The project comes from the site's hostname, so the paths take no projectId. Any other method gets 405 method_not_allowed.
List Conversations
Path Parameters
projectIdQuery Parameters
visitorIdResponse
Up to 50 conversations, newest first. Each conversation is titled from its first question.
Load a Transcript
/v1/projects/{projectId}/chat/sessions/{sessionId}Path Parameters
projectIdsessionIdQuery Parameters
visitorId404.Response
The conversation's messages in chronological order (up to 100).
Rename a Conversation
/v1/projects/{projectId}/chat/sessions/{sessionId}Path Parameters
projectIdsessionIdRequest Body
visitorId404.title404.Delete a Conversation
/v1/projects/{projectId}/chat/sessions/{sessionId}Deletes the conversation and all of its messages. This can't be undone.
Path Parameters
projectIdsessionIdQuery Parameters
visitorId404.Error Responses
| Status | Code | When |
|---|---|---|
| 400 | INVALID_REQUEST | Missing visitorId, or the session ID is not a UUID |
| 400 | validation_error | Rename body is missing visitorId or title, or title is over 480 characters |
| 403 | FORBIDDEN | The site is private (password, invite-only or SSO) and the request didn't come through the doc site ("Ask from the docs site") |
| 404 | NOT_FOUND | The session doesn't exist, or belongs to a different project or visitor |
Example
Rename a conversation:
Related
/ask page these endpoints power