Conversation History

List a visitor's past chat conversations and load full transcripts. These endpoints power the sidebar of the doc site's agentic mode (/ask page — available when the Agentic Mode add-on is enabled), where visitors can search, resume, and replay previous conversations.

Both endpoints are public (no API key required) but strictly scoped: a conversation is only returned when it belongs to both the project and the requesting visitorId — one visitor can never read another visitor's conversations.

List Conversations

Path Parameters

Query Parameters

Response

Up to 50 conversations, newest first. Each conversation is titled from its first question.

{
  "data": {
    "sessions": [
      {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "title": "How do I add a custom domain?",
        "createdAt": "2026-07-12T09:30:00.000Z"
      }
    ]
  }
}

Load a Transcript

Path Parameters

Query Parameters

Response

The conversation's messages in chronological order (up to 100).

{
  "data": {
    "messages": [
      {
        "id": "9b2e6c1a-…",
        "role": "user",
        "content": "How do I add a custom domain?",
        "createdAt": "2026-07-12T09:30:00.000Z"
      },
      {
        "id": "4f81d3b7-…",
        "role": "assistant",
        "content": "Go to Settings → Custom Domains… [guides/custom-domains]",
        "createdAt": "2026-07-12T09:30:04.000Z"
      }
    ]
  }
}

Error Responses

Example

curl "https://api.syntext.dev/v1/projects/prj_abc123/chat/sessions?visitorId=vis_9f8e7d"

Related

• Ask the AI Assistant — start or continue a conversation
• Agentic mode — the /ask page these endpoints power