GET
List a session’s turns
See Reading the conversation for pagination defaults and how a truncated answer is retrieved in full from its job.

Authorizations

x-api-key
string
header
required

API key for authentication

Headers

Idempotency-Key
string

Accepted for client uniformity but IGNORED on this endpoint. It has no side effects, and a retry can legitimately return different results, so replaying a cached response would hand back stale data. Every request executes fresh: no 24h window, no replay, no Idempotent-Replayed header, and no key-reuse 422.

Path Parameters

session_id
string
required

Session to read turns from.

Query Parameters

limit
number
default:20

Turns per page (default 20, max 50). Lower than other list routes because a turn carries a whole answer.

Required range: 1 <= x <= 50
cursor
string

Opaque cursor from a previous response’s pagination.nextCursor. Omit it for the first page.

Response

A page of turns.

data
object[]
required
pagination
object
required