Sign in

v34

latestOpenAPI 3.1.0raw.githubusercontent.com2026-06-09194386949.7 KB
Chat

Create Session

Create a chat session, optionally bound to indexes (locked after the first message).

post/api/v1/chat

Query parameters

project_idstring uuid nullable
organization_idstring uuid nullable

Cookies

sessionstring nullable

Request body

index_idsstring[] nullable

Indexes this session will retrieve from. Once set and the first message has been sent, the source set is locked for the session's lifetime. Leave null to create an unbound session.

Example request

{
  "index_ids": [
    "idx-abc123",
    "idx-def456"
  ]
}

Response

Successful Response

session_idstring required

Unique session identifier.

generated_titlestring nullable

Auto-generated title derived from the first user message.

last_updated_atstring required

ISO-format timestamp showing when the session was last updated.

index_idsstring[] nullable

Indexes this session is bound to. Null on unbound sessions.

Example response

{
  "session_id": "ses-abc123",
  "generated_title": "What were the main findings in Q3?...",
  "last_updated_at": "2026-04-22T12:34:41.342245",
  "index_ids": [
    "idx-abc123",
    "idx-def456"
  ]
}