Sessions

A session is a persistent AI conversation context. Create one to begin a conversation, attach documents so the AI can reason about their content, send messages back and forth, then end it when the user is done. Ended sessions become read-only but their full message history remains accessible.

3 endpointsBearer sk_live_xxxBase: /v1/sdk/chat

AuthAuthorization: Bearer sk_live_xxxxxxxxxxxxxxxx

Create session

Opens a new AI chat session. Sessions remain active until explicitly ended. Optionally provide a title to identify the session in list views.

List sessions

Returns all sessions under your account, newest first. Each record includes status, message count, and timestamps. Use this to build session list UIs or audit active conversations.

End session

Marks a session as ended. Ended sessions are read-only - you can still retrieve their message history but cannot send new messages. Call this once the user has finished interacting with the AI to free up context resources.