> ## 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.

# RunsListRunsCommand

> Input object in the GraphQL API.

RunsListRunsCommand

| Field | Type | Required | Description |
| - | - | - | - |
| `taskId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | Discover agent runs with this persisted task identity across conversations. Matches canonical task metadata or the first enqueue request; results are not task authorization evidence. |
| `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. |
| `cursor` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Opaque cursor returned by the previous page. Reuse with unchanged filters and ordering. |
| `sortBy` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Field used to order runs: created\_at, status or duration. Defaults to created\_at. |
| `sortOrder` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Sort direction: asc or desc. Defaults to desc. |
| `status` | [`[String!]`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Run statuses to include. Values within this filter use OR; different filters use AND. |
| `targetType` | [`[String!]`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Execution definition types to include: agent, task, workflow or legacy eval. |
| `triggerType` | [`[String!]`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Trigger types to include: user, api\_key, service\_account, system, schedule, webhook, agent, task or workflow. |
| `rootOnly` | [`Boolean`](https://veryfront.com/docs/cloud/graphql/types/boolean) | No | true lists only top-level runs (parent\_run\_id null). Defaults to false. |
| `parentRunId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | |
| `targetId` | [`[ID!]`](https://veryfront.com/docs/cloud/graphql/types/id) | No | |
| `triggerId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | |
| `projectReference` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | |
| `conversationId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | |

[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.