Resume run

resumeRun(command: RunsResumeRunCommand!, idempotencyKey: String): RunsRun!

Requires project.runs.write.

Arguments

ArgumentTypeRequiredDescription
commandRunsResumeRunCommand!Yes
idempotencyKeyStringNoRetry key for this mutation (1-128 characters); overrides Idempotency-Key.

Input fields

command

RunsResumeRunCommand

FieldTypeRequiredDescription
runIdID!YesRun to resume. Conversation-owned runs also require editor access on the conversation. A fresh resume signal must match the current wait; a mismatch returns 409. An authorized retry of the identical request with the same idempotency key returns its stored result.
inputRunsResumeRunCommandInput!Yes

Response

Returns RunsRun!. Open the type for its fields and nested types.

FieldTypeDescription
idID!Unique run UUID.
runIdID!Public run ID that run events (metadata.run_id) and runtime tools name. Equals id for runs the server names; older runs keep their run_ ID.
statusString!Current execution state.
projectIdID!Project containing the run.
targetRunsRunTarget!Execution definition; its ID may be null only on historical runs.
inputJSONBusiness input supplied when the run was created.
outputJSONFinal business output; null until successful finalization.
errorRunsRunErrorFailure details, present only when the run failed.

All fields of RunsRun.

Types marked with ! cannot be null. Lists use [Type] notation. The type index lists all published input and response types.

Example

graphql
mutation ResumeRun($command: RunsResumeRunCommand!, $idempotencyKey: String) {
  resumeRun(command: $command, idempotencyKey: $idempotencyKey) {
    id
    projectId
    runId
    status
    createdAt
  }
}
json
{
  "command": {
    "runId": "11111111-1111-4111-8111-111111111111",
    "input": {
      "type": "manual"
    }
  }
}