Skip to main content
GET
Get session turns

Authorizations

Authorization
string
header
required

Bearer token: an organization API key (ak_…) created under Settings → API Keys, or a dashboard user session token. Agent keys (xe_…) are not accepted here. Endpoints marked as user-only in their description reject organization keys with 403.

Path Parameters

session_id
string
required

Query Parameters

from
integer
required
Required range: x >= 0
to
integer
required
Required range: x >= 0
whole
boolean
default:false

Response

Successful Response

id
string
required
index
integer
required
status
enum<string>
required
Available options:
allowed,
blocked,
escalated,
error,
running,
incomplete
started_at
string<date-time>
required
ended_at
string<date-time> | null
agent
AgentRef · object | null

An agent named on a telemetry read: the agent a turn ran on, or the agent that called it. A deleted agent keeps its name (its row stays) and says it is deleted; an id that names no agent of the organisation reads its id as the name and says it is unknown (there is no agent to open).

flows
SessionFlow · object[]
steps
SessionStep · object[]
step_count
integer
default:0
steps_loaded
boolean
default:true
steps_omitted
integer
default:0