List turns

List a session’s turns.

GET /v1/sessions/{session_id}/turns

List turns

cURL

curl --request GET \
  --url https://api.{domain}/v1/sessions/{session_id}/turns \
  --header 'Authorization: Bearer <token>'

200

{
  "object": "list",
  "data": [
    {
      "object": "turn",
      "id": "<string>",
      "session_id": "<string>",
      "status": "working",
      "created_at": 123,
      "started_at": 123,
      "completed_at": 123,
      "artifacts": "pending",
      "artifacts_skipped": [
        {
          "path": "<string>",
          "reason": "<string>"
        }
      ],
      "subagent_id": "<string>",
      "error": {}
    }
  ],
  "has_more": true,
  "last_id": "<string>"
}

Authorizations

Authorization · string · header · required

A gbr_pat_ access token. Scopes are recorded on the token when it is minted.

Query Parameters

limit · integer

How many to return, 1–100. Default 20.

Required range: 1 <= x <= 100

order · enum<string>

Newest first (desc, the default) or oldest first (asc).

Available options: asc, desc

after · string

The last_id of the previous page. A cursor this collection cannot place — expired, deleted, or never issued — answers with an empty page rather than starting over, so a paging loop ends instead of repeating itself.

Response

200

application/json

List a session's turns.

object · string · required

Always list. Names the shape, so a value can be identified without knowing which call returned it.

Allowed value: "list"

data · object[] · required

Show child attributes

has_more · boolean

last_id · string | null