> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# RunsListRunEventsCommand

> Input object in the GraphQL API.

RunsListRunEventsCommand

| Field | Type | Required | Description |
| - | - | - | - |
| `runId` | [`ID!`](https://veryfront.com/docs/cloud/graphql/types/id) | Yes | |
| `cursor` | [`JSON`](https://veryfront.com/docs/cloud/graphql/types/json) | No | The 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. |
| `limit` | [`Float`](https://veryfront.com/docs/cloud/graphql/types/float) | No | Maximum number of records in a page, from 1 to 100. Defaults to 20. |
| `sortOrder` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Event order by durable event id. `asc` returns older events first; `desc` returns newer events first. Defaults to `asc`. |
| `afterEventId` | [`Float`](https://veryfront.com/docs/cloud/graphql/types/float) | No | Deprecated. Use `cursor`. Accepted as an ascending cursor; 0 means no cursor. |
| `eventClass` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Event class to include: `fact` for state changes or `delta` for streaming fragments. If omitted, returns both. |
| `eventType` | [`[String!]`](https://veryfront.com/docs/cloud/graphql/types/string) | No | |
| `isError` | [`Boolean`](https://veryfront.com/docs/cloud/graphql/types/boolean) | No | If true, returns only events with `is_error: true`. If false, returns other events. If omitted, returns both. |
| `start` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Only events created at or after this instant (ISO 8601 with a UTC offset, inclusive). A summary bucket start can be sent as is. |
| `end` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Only 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. |
| `spanId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | Only 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>). |
| `turnId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | Only events whose envelope turn\_id, as served to the caller, is exactly this value (message:\<id>, with a non-empty \<id>). |
| `search` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Case-insensitive substring of the event payload JSON as served to the caller (1-200 characters after trimming, matched literally). |
| `includeDescendants` | [`Boolean`](https://veryfront.com/docs/cloud/graphql/types/boolean) | No | If 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. |

[All GraphQL types](https://veryfront.com/docs/cloud/graphql/schema.md) · [Operations](https://veryfront.com/docs/cloud/graphql.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.