v1

latestOpenAPI 3.0.02026-07-26242779.3 KB

Get agent sessions

Retrieves sessions for the specified agent with optional filtering and pagination.

get/agents/{agentName}/sessions

Path parameters

agentNamestring required

Name of the agent to retrieve sessions for

Query parameters

limitinteger

Maximum number of sessions to return

offsetinteger

Number of sessions to skip

deploymentIdstring

Filter sessions to a specific deployment ID

startTimeinteger

Filter sessions to those after this Unix timestamp

endTimeinteger

Filter sessions to those before this Unix timestamp

status'active' | 'ended' | 'all'

Filter sessions to those with this status

startType'cold' | 'warm' | 'all'

Filter sessions to those with this start type

startTimeMininteger

Filter sessions to those whose start times are greater than this value in seconds

startTimeMaxinteger

Filter sessions to those whose start times are less than this value in seconds

Response

Agent sessions retrieved successfully

total_countinteger

Total number of sessions matching the parameters