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

# CreateRunInput

> Input object in the GraphQL API.

The REST POST /runs body. Top-level fields are camelCase; request is the kind-specific REST request object in the REST spelling (snake\_case). Fields that do not apply to the kind must be null.

| Field | Type | Required | Description |
| - | - | - | - |
| `kind` | [`String!`](/docs/cloud/graphql/types/string) | Yes | agent, workflow, task or eval. |
| `owner` | [`RunOwnerInput!`](/docs/cloud/graphql/types/runownerinput) | Yes | |
| `publicId` | [`String`](/docs/cloud/graphql/types/string) | No | Caller-chosen run id. Repeating a publicId returns the existing run with duplicate true. |
| `parentRunId` | [`String`](/docs/cloud/graphql/types/string) | No | |
| `trigger` | [`RunTriggerInput`](/docs/cloud/graphql/types/runtriggerinput) | No | |
| `composingUserId` | [`ID`](/docs/cloud/graphql/types/id) | No | Conversation-owned agent runs: the account that composed the run. |
| `conversationMode` | [`String`](/docs/cloud/graphql/types/string) | No | Project-owned agent runs: none (default), create\_new or existing. |
| `conversationId` | [`ID`](/docs/cloud/graphql/types/id) | No | Project-owned agent runs with conversationMode existing. |
| `request` | [`JSON!`](/docs/cloud/graphql/types/json) | Yes | The kind-specific request, as in the REST body: workflow \{name, workflow\_id, target, input, start\_mode, runtime\_target\_*}; task \{target, name, batch\_id, input, config, timeout\_seconds, backoff\_limit, runtime\_target\_*}; eval \{name, target, input, config, start\_mode, runtime\_target\_\*}; agent \{mode: "agent", name and the agent request fields}. name is the run's title. |

[All GraphQL types](/docs/cloud/graphql/schema) · [Operations](/docs/cloud/graphql)


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