Create a new session

POST

sessions

init

curl --request POST \
  --url https://api.svantic.com/sessions/init \
  --header 'Content-Type: application/json' \
  --data '
{
  "instance_id": "string",
  "user_id": "string"
}
'

{
  "session_id": "string",
  "instance_id": "string",
  "agent_type": "string"
}

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.

Interrupt in-flight streams

Close a session

Create a new session

curl --request POST \
  --url https://api.svantic.com/sessions/init \
  --header 'Content-Type: application/json' \
  --data '
{
  "instance_id": "string",
  "user_id": "string"
}
'

{
  "session_id": "string",
  "instance_id": "string",
  "agent_type": "string"
}