API ReferenceAgent Task
agentTask.createRun
Type: Mutation · Auth: Workspace-aware
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| taskId | string | Yes | — | ID of the associated task |
| runType | enum(plan, execute, retry, approval_execution) | Yes | — | Run type |
| executorKind | enum(automation, agent_pipeline, workflow, human) | Yes | — | Executor kind |
| status | enum(started, completed, failed, canceled) | Yes | "started" | Status |
| inputPayload | object | No | — | Input payload |
| planPayload | object | No | — | Plan payload |
| resultPayload | object | No | — | Result payload |
| error | string | No | — | Error |
| traceRefId | string | No | — | ID of the associated trace ref |
| workspaceId | string | No | — | ID of the associated workspace |
Example
{
"taskId": "550e8400-e29b-41d4-a716-446655440000",
"runType": "plan",
"executorKind": "automation",
"status": "started",
"inputPayload": null,
"planPayload": null
}