Skip to main content
GET
session.turns.get(turnId)

Authorizations

Authorization
string
header
required

An API key, or a session token on its own session

Path Parameters

id
string
required

The session's ID

Pattern: ^ses_[0-7][0-9a-hjkmnp-tv-z]{25}$
turnId
string
required

The turn's ID

Pattern: ^trn_[0-7][0-9a-hjkmnp-tv-z]{25}$

Response

The turn

The projection of a turn's turn.started and turn.ended events.

id
string
required
Pattern: ^trn_[0-7][0-9a-hjkmnp-tv-z]{25}$
sessionId
string
required
Pattern: ^ses_[0-7][0-9a-hjkmnp-tv-z]{25}$
status
enum<string>
required
Available options:
running,
completed,
stopped,
failed,
discarded
origin
enum<string>
required

user: started over waiting messages; harness: started by the harness on its own, with no inputs, never retried.

Available options:
user,
harness
inputSeqs
integer[]
required

The seqs of the user messages the turn consumed; empty for a harness turn.

A position in an agent's event log.

Required range: 0 <= x <= 9007199254740991
attempt
integer
required
Required range: x >= 1
error
object | null
required
retryAt
string<date-time> | null
required

RFC 3339 in UTC with milliseconds.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\.[0-9]{3}Z$
startedSeq
integer
required

A position in an agent's event log.

Required range: 0 <= x <= 9007199254740991
endedSeq
integer | null
required

A position in an agent's event log.

Required range: 0 <= x <= 9007199254740991
startedAt
string<date-time>
required

RFC 3339 in UTC with milliseconds.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\.[0-9]{3}Z$
endedAt
string<date-time> | null
required

RFC 3339 in UTC with milliseconds.

Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}\.[0-9]{3}Z$
timing
object | null
required

Where the turn's time went; null while running and for a discarded turn.