Skip to content

List runs

GET
/api/v1/runs

List the authenticated submitter’s own run history.

Credential scopes: runs:read

Resource authority: Run submitter; model-administrator history uses the model run-history route.

Retry: Repeat GET using the same resource identity; each request rechecks current credential and resource authority.

Guards: This personal inventory is creator-scoped.

Retain: User identity, filters and opaque cursor.

Specific failures: 400 invalid_pagination; 403 insufficient_scope

Next action: Inspect a returned run or use model run history for administrative investigation. Worked workflow

limit
integer format: int32
default: 20 >= 1 <= 100

Maximum runs per page.

cursor
string
<= 2048 characters

Opaque continuation cursor, scoped to this user and these filters.

model_id
string
<= 64 characters

Filter by exact model identity.

status

Public execution state. Delegated preparation and collection are running.

string
Allowed values: queued running succeeded failed cancelled

Filter by current public run state.

created_after
string format: date-time

Exclusive lower creation-time bound in RFC3339, at most six fractional digits.

created_before
string format: date-time

Exclusive upper creation-time bound in RFC3339, at most six fractional digits.

Only this creator’s run summaries, with an opaque continuation cursor. Model-grant revocation does not remove access to accepted work.

Media typeapplication/json
object
items
required
Array<object>

Small history entries exclude inputs and service-wide queue information.

object
blocked_reason
One of:
null
cancelled_at
string | null format: date-time
context_id
required
string
created_at
required
string format: date-time
execution_location
required
string
last_observed_at

API receipt time of the latest qualifying execution observation.

string | null format: date-time
model_id
required
string
observation_freshness
required

API confirmation age: fresh below 60 seconds, stale at or above 60 seconds. Missing or future confirmation times are unknown.

string
Allowed values: unknown fresh stale
phase
One of:
null
publication_id
required

Immutable publication captured at acceptance.

string
purpose

Immutable submission intent. Candidate trials retain author/compute authority checks.

string
Allowed values: standard candidate_trial
run_id
required
string format: uuid
state
required

Public execution state. Delegated preparation and collection are running.

string
Allowed values: queued running succeeded failed cancelled
next_cursor

Opaque continuation. Repeat the same filters; the page size may change.

string | null
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Invalid, unknown, duplicate, or incompatible filters, limits, or cursor. Code invalid_pagination.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

An active user credential is required. Code unauthenticated.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

WWW-Authenticate
string

Bearer

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

The credential does not permit this operation (insufficient_scope).

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

413: the request body exceeds the configured size limit.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Authentication or run inspection is temporarily unavailable. Code run_inspection_unavailable for inspection failures.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

An HTTP request failed; inspect the stable error code and request ID.

Media typeapplication/json

The common JSON body for errors returned by the HTTP application.

object
code
required

Stable machine-readable error code.

string
details
One of:
null
message
required

Safe explanation without internal errors or submitted input values.

string
request_id
required

Matches the response’s x-request-id header.

string
Cache-Control
string

No-store

x-request-id
string

Always present. A fresh server-generated UUID for this request; incoming IDs are ignored. On errors, this equals the response body’s request_id.

Documentation 205dcb3116ea · public sources 8c70356d340f · built .Download documentation identity.