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

# RunsCreateRunCommandInput

> Input object in the GraphQL API.

Creates a run for a project and target, or executes a saved schedule or webhook. Input is business data; configuration and execution settings are separate.

| Field | Type | Required | Description |
| - | - | - | - |
| `projectId` | [`ID!`](https://veryfront.com/docs/cloud/graphql/types/id) | Yes | UUID of the project containing the execution definition or saved source. |
| `title` | [`String`](https://veryfront.com/docs/cloud/graphql/types/string) | No | Optional display title for the accepted run. |
| `labels` | [`JSON`](https://veryfront.com/docs/cloud/graphql/types/json) | No | Labels used to organize runs. |
| `target` | [`RunsCreateRunCommandInputTarget`](https://veryfront.com/docs/cloud/graphql/types/runscreateruncommandinputtarget) | No | Definition executed by this run. |
| `input` | [`JSON`](https://veryfront.com/docs/cloud/graphql/types/json) | No | Depending on the selected variant: Business input passed to the definition unchanged; omitted input resolves to null. A JSON value. |
| `config` | [`JSON`](https://veryfront.com/docs/cloud/graphql/types/json) | No | Definition-specific configuration; business keys retain their spelling on every transport. Agent targets with `conversation_id` read `agent_admission` (AgentAdmissionConfig). |
| `execution` | [`RunsCreateRunCommandInputExecution`](https://veryfront.com/docs/cloud/graphql/types/runscreateruncommandinputexecution) | No | Execution overrides, separate from business input and configuration. |
| `parentRunId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | Canonical UUID of the authenticated runtime parent; ordinary users cannot assert parent authority. |
| `toolCallId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | Durable tool invocation on an agent parent; requires parent\_run\_id and excludes node\_id. |
| `nodeId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | Started workflow node on the parent; requires parent\_run\_id and excludes tool\_call\_id. |
| `conversationId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | Conversation associated with an agent admission, when applicable. |
| `batchId` | [`ID`](https://veryfront.com/docs/cloud/graphql/types/id) | No | Batch UUID associated with the accepted run. |
| `source` | [`RunsCreateRunCommandInputSource`](https://veryfront.com/docs/cloud/graphql/types/runscreateruncommandinputsource) | No | Depending on the selected variant: Saved schedule supplying the target and execution configuration. Saved webhook to execute. |

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