Get one turn

GET/o/{org}/p/{project}/sessions/{session}/turns/{turn}
View .md

Path parameters

orgstringrequired

The org's slug or id. A caller with no role in the org gets 404.

projectstringrequired

A Project's handle (name) or id, resolved inside {org} — OR the reserved sentinel _ meaning "no Project" (a direct-repo / repo-less dispatch on POST; "no Project constraint, resolve by session id alone" everywhere else). A real handle that doesn't match the session's actual Project is 404.

sessionstringrequired

The session's full id (execution_id).

turnstringrequired

A turn id from GET …/turns, or turn_id from a sent follow-up.

Format uuid

Responses

200The turn.
idstringrequired
Format uuid
ordinalintegerrequired

1 for the prompt that started the session, then one per delivered follow-up.

min 1
statusstringrequired
One ofrunningcompletedneeds_reviewfailedcancelledexpiredinterrupted
promptstring | nullrequired
resultanyrequired

The turn's answer, as GET …/sessions/{session}/result returned it when the turn ended.

started_atstringrequired
Format date-time
ended_atstring | nullrequired
Format date-time
401No bearer, an unknown, revoked or expired one, or an API key on a route keys cannot call.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional
404No such resource for the caller, including one that exists in an org the caller cannot see.
errorstringoptional

A sentence for a person.

codestringoptional

Stable machine code, e.g. AUTH_FAILED, NOT_FOUND, VALIDATION_ERROR, RATE_LIMITED, PLAN_REQUIRED.

error_codestringoptional

The machine code on routes that name it this way.

messagestringoptional
requestIdstringoptional