Skip to main content
Run read endpoints are useful for custom consoles, export jobs, and integration tests. They require usage:read.

List runs

Query parameters:
Treat cursors as opaque. Do not parse or construct them in client code.

Get one Run

The path accepts either the internal Run UUID or your external runId. The response includes up to 100 events and a hasMoreEvents flag.

Page through events

When hasMoreEvents is true, request:
Pass each returned nextCursor unchanged:
Event pages contain at most 200 items and default to 100.
Run payloads can contain prompts, tool arguments, and model responses. Apply authorization before exposing this API through your own service, and avoid copying raw payloads into application logs.