| Field | Type | Required | Description |
|---|---|---|---|
projectId | ID! | Yes | UUID of the project containing the execution definition or saved source. |
title | String | No | Optional display title for the accepted run. |
labels | JSON | No | Labels used to organize runs. |
target | RunsCreateRunCommandInputTarget | No | Definition executed by this run. |
input | JSON | No | Depending on the selected variant: Business input passed to the definition unchanged; omitted input resolves to null. A JSON value. |
config | JSON | No | Definition-specific configuration; business keys retain their spelling on every transport. Agent targets with conversation_id read agent_admission (AgentAdmissionConfig). |
execution | RunsCreateRunCommandInputExecution | No | Execution overrides, separate from business input and configuration. |
parentRunId | ID | No | Canonical UUID of the authenticated runtime parent; ordinary users cannot assert parent authority. |
toolCallId | ID | No | Durable tool invocation on an agent parent; requires parent_run_id and excludes node_id. |
nodeId | ID | No | Started workflow node on the parent; requires parent_run_id and excludes tool_call_id. |
conversationId | ID | No | Conversation associated with an agent admission, when applicable. |
batchId | ID | No | Batch UUID associated with the accepted run. |
source | RunsCreateRunCommandInputSource | No | Depending on the selected variant: Saved schedule supplying the target and execution configuration. Saved webhook to execute. |
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.
All GraphQL types · Operations