Skip to main content
POST
Create a new session

Body

application/json

Gateway POST /sessions/init — JWT-authenticated. The tenant_id is extracted from the JWT; session_id is generated server-side.

instance_id
string
required

The registered agent instance to create the session for.

user_id
string

Optional end-user identifier. Defaults to the authenticated identity when omitted.

Response

Session created.

Gateway success body for session init.

session_id
string
required

Server-generated session identifier.

instance_id
string
required

The agent instance bound to this session.

agent_type
string
required

Logical agent type of the bound instance.