Skip to main content
POST
/
sessions
/
init
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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.svantic.com/llms.txt

Use this file to discover all available pages before exploring further.

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.