Agent Sessions
Get a session
Retrieves the details of a hosted agent session by agent name and session identifier.
Path parameters
agent_name
string
required
The name of the agent.
session_id
string
required
The session identifier.
Query parameters
api-version
string
required
The API version to use for this operation.
Responses
The request has succeeded.
Body
agent_session_id
string
required
The session identifier.
version_indicator
version_ref
required
Version indicator determining which agent version backs the session.
version_ref
VersionRefIndicator
Version indicator that references a specific agent version by name.
type
enum
required
Discriminator value for version_ref.
agent_version
string
required
The agent version identifier returned by the agent version APIs.
status
string | enum
required
The status of an agent session.
enum
created_at
integer
required
The Unix timestamp (in seconds) when the session was created.
last_accessed_at
integer
required
The Unix timestamp (in seconds) when the session was last accessed.
expires_at
integer
required
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.
Request
GET /agents/{agent_name}/endpoint/sessions/{session_id} HTTP/1.1Response
Status: 200
Content-Type: application/jsonStatus: 4XX
Content-Type: application/jsonStatus: 5XX
Content-Type: application/json