Sign in
Docs
API referenceCoordinator

API reference

List a thread's turns

Have a token? Manage tokens in the console
GET
/v1/coordinator/threads/{thread_id}/turns

A thread's turns, oldest first: whose seat, state, attempt, runner, the pack's hash, the outcome, the reply, the provider session and the cost as evidence.

Needs scope coordinator:read.

Authorization

bearer
headerAuthorizationBearer <JWT>

An access token from the identity provider: a person's, or a customer's from the client credentials grant with an API key (developers.inorbit.hr). The gateway verifies it; the audience is iohr-api.

Path Parameters

thread_id*string

The thread's id, thr_ and a ULID.

Query Parameters

account_id?string
page_size?integer

At most this many; 0 means 50, above 200 means 200.

Formatint32
page_token?string

From the previous page's next_page_token.

Response Body

iohr.coordinator.v1.ListTurnsResponse

application/json
  1. response

iohr.coordinator.v1.ListTurnsResponse

next_page_token*string
turns*array<>
import { ApiError, Public } from "@inorbithr/sdk";// Reads INORBIT_TOKEN, or INORBIT_KEY_ID and INORBIT_KEY_SECRET.const api = Public.fromEnv();try {  for await (const turn of api.coordinator.allListTurns("<thread_id>")) {    console.log(turn);  }} catch (e) {  if (!(e instanceof ApiError)) throw e;  console.error(`${e.code}: ${e.problem} (request id ${e.raw.requestId})`);  process.exitCode = 1;}

npm install @inorbithr/sdk. Calls the package's public surface; an operation newer than your package needs the next release or a client generated for your account. The SDKs.

Example Response
{  "next_page_token": "string",  "turns": [    {      "attempt": 0,      "cost": {        "duration_ms": "string",        "label": "string",        "usage": {          "cache_read": "string",          "cache_write": "string",          "input": "string",          "output": "string"        },        "usd_estimate": 0.1      },      "created_at": "string",      "denied_tools": [        "string"      ],      "duration_ms": "string",      "job_id": "string",      "kind": "string",      "lease_id": "string",      "model": "string",      "num_turns": 0,      "origin": "string",      "outcome": "string",      "pack_sha256": "string",      "provider": "string",      "provider_session_id": "string",      "reply": {        "actions": [          {            "kind": "string",            "payload_json": "string"          }        ],        "evidence": [          "string"        ],        "left": [          "string"        ],        "say": "string",        "state": "string"      },      "reported_at": "string",      "resumed": true,      "runner_id": "string",      "started_at": "string",      "state": "string",      "thread_id": "string",      "turn_id": "string",      "updated_at": "string",      "user": "string"    }  ]}