Agent Sessions
Create a session
Creates a new session for an agent endpoint.
The endpoint resolves the backing agent version from version_indicator and
enforces session ownership using the provided user identity for session-mutating operations.
Padparameters
agent_name
string
vereist
The name of the agent to create a session for.
Queryparameters
api-version
string
vereist
The API version to use for this operation.
Aanvraagbody
agent_session_id
string
Optional caller-provided session ID. If specified, it must be unique within the agent endpoint. Auto-generated if omitted.
version_indicator
version_ref
vereist
Version indicator determining which agent version backs the session.
version_ref
VersionRefIndicator
Version indicator that references a specific agent version by name.
type
enum
vereist
Discriminator value for version_ref.
agent_version
string
vereist
The agent version identifier returned by the agent version APIs.
Antwoorden
The request has succeeded and a new resource has been created as a result.
Hoofdtekst
agent_session_id
string
vereist
The session identifier.
version_indicator
version_ref
vereist
Version indicator determining which agent version backs the session.
version_ref
VersionRefIndicator
Version indicator that references a specific agent version by name.
type
enum
vereist
Discriminator value for version_ref.
agent_version
string
vereist
The agent version identifier returned by the agent version APIs.
status
string | enum
vereist
The status of an agent session.
enum
created_at
integer
vereist
The Unix timestamp (in seconds) when the session was created.
last_accessed_at
integer
vereist
The Unix timestamp (in seconds) when the session was last accessed.
expires_at
integer
vereist
The Unix timestamp (in seconds) when the session expires (rolling, 30 days from last activity).
stopped_at
integer
The Unix timestamp (in seconds) when the session sandbox was last observed to stop or go idle. Present only after the session has gone idle at least once, used for accurate idle-billing reconciliation.
Aanvraag
POST /agents/{agent_name}/endpoint/sessions HTTP/1.1Respons
Status: 201
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json