Sign in

v12

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-014994227.2 KB
runs

List run events

Returns paginated run events for a session, filtered by session_id.

post/runs/events

Request body

$schemastring uri

A URL to the JSON Schema for this object.

event_typesstring[] nullable

EventTypes restricts results to specific event type codes (RUN_STARTED / OUTPUT_LOG / SDK_CALL_COMPLETED / etc.).

limitinteger required

Maximum number of events to return.

offsetinteger required

Pagination offset.

session_idstring required

Filters events to a specific device session (formerly allocation_id; W6-2).

Example request

{
  "$schema": "/api/v1/RunEventsRequest.json"
}

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

inference_costsobject required

Billed microdollars per inference_id.

limitinteger required

Page size used for this response.

offsetinteger required

Pagination offset used for this response.

retention_expiredboolean required

True when the trace is past the plan's retention window; events are withheld.

sdk_call_costsobject required

Billed microdollars per SDK-call span_id.

totalinteger required

Total number of events matching the query.

Example response

{
  "$schema": "/api/v1/RunEventsResponse.json"
}