Skip to main content
POST
Create a new session

Headers

x-user-id
string
required

Caller's user ID. Temporary header-based identity; will be replaced by JWT auth.

Body

application/json

Request body for creating a new session.

agent_id
string
required

Agent this session belongs to.

workspace_id
string | null

Workspace this session belongs to.

name
string | null

Display name. Defaults to current datetime if omitted.

chat_model_config
ChatModelConfig · object | null

Model provider and parameters. Can be set later via PATCH.

fallback_chat_model_config
ChatModelConfig · object | null

Fallback model used when the primary model fails. Can be set later via PATCH.

Response

Successful Response

Response body after creating a session.

session_id
string
required

Server-assigned session identifier.