List run events

listRunEvents(command: RunsListRunEventsCommand!): RunsEventConnection!

Arguments

ArgumentTypeRequired
commandRunsListRunEventsCommand!Yes

Input fields

command

RunsListRunEventsCommand

FieldTypeRequiredDescription
runIdID!Yes
cursorJSONNoThe previous page’s continuation cursor. Released row reads use a positive event_id. With event_representation=run-events-v1, this is the opaque page_info.next_cursor token from the previous target page.
limitFloatNoMaximum number of records in a page, from 1 to 100. Defaults to 20.
sortOrderStringNoEvent order by durable event id. asc returns older events first; desc returns newer events first. Defaults to asc.
afterEventIdFloatNoDeprecated. Use cursor. Accepted as an ascending cursor; 0 means no cursor.
eventClassStringNoEvent class to include: fact for state changes or delta for streaming fragments. If omitted, returns both.
eventType[String!]No
isErrorBooleanNoIf true, returns only events with is_error: true. If false, returns other events. If omitted, returns both.
startStringNoOnly events created at or after this instant (ISO 8601 with a UTC offset, inclusive). A summary bucket start can be sent as is.
endStringNoOnly events created before this instant (ISO 8601 with a UTC offset, exclusive). Must be later than start. A summary bucket end can be sent as is.
spanIdIDNoOnly events whose envelope span_id, as served to the caller, is exactly this value (tool:<id>, message:<id>, step:<id>, input_request:<id>, run:<id>, with a non-empty <id>).
turnIdIDNoOnly events whose envelope turn_id, as served to the caller, is exactly this value (message:<id>, with a non-empty <id>).
searchStringNoCase-insensitive substring of the event payload JSON as served to the caller (1-200 characters after trimming, matched literally).
includeDescendantsBooleanNoIf true, includes events from readable descendant runs, up to 16 generations. Results share one event_id order and cursor. Each event retains its run_id and the payload visibility permitted for that run. Runs the caller cannot read are excluded. Defaults to false. If at least one descendant is included, task or workflow runs without stored events do not contribute synthetic lifecycle events. Event IDs are allocated before commit. During active writes, ascending pagination can pass an ID that another run commits later.

Response

Returns RunsEventConnection!. Open the type for its fields and nested types.

FieldTypeDescription
data[RunsEvent!]!
pageInfoPageInfo!Opaque cursor for the next page; null means there are no more results.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
query ListRunEvents($command: RunsListRunEventsCommand!) {
  listRunEvents(command: $command) {
    data {
      spanId
      runId
      createdAt
      eventClass
      eventId
    }
    pageInfo {
      hasNextPage
      endCursor
      hasPreviousPage
      startCursor
    }
  }
}
json
{
  "command": {
    "runId": "11111111-1111-4111-8111-111111111111"
  }
}