Chat Sessions

List Sessions

GET /v1/chat/sessions

Returns all chat sessions for the current user.

Scope: chat:read

Create Session

POST /v1/chat/sessions

Creates a new chat session. Sessions are also auto-created when using the agent endpoint without a sessionId.

Scope: chat:write

Get Session

GET /v1/chat/sessions/{id}

Returns a session with its full message history.

Scope: chat:read

Delete Session

DELETE /v1/chat/sessions/{id}

Permanently deletes a chat session and all its messages.

Scope: chat:write

Send Message

POST /v1/chat/sessions/{id}/messages

Adds a message to an existing session. For AI-powered responses, use the Agent endpoint instead.

Scope: chat:write

{
  "content": "Your message here",
  "role": "user"
}