Skip to main content
POST
Create a durable AI chat session (bearer token)

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
conversation_id
string
required
Required string length: 1 - 128
agent_task_id
string<uuid> | null
cluster_id
string<uuid> | null
idempotency_key
string | null
Maximum string length: 128
mode
enum<string>
default:agent
Available options:
ask,
agent,
plan

Response

The AISession document (an idempotency_key replay returns the existing session)