Get run details

Unique identifier for the run

Unique identifier for the task (typically matches run_id). Deprecated - use run_id instead.

Human-readable title for the run

Current state of the run:

• QUEUED: Run is waiting to be picked up
• PENDING: Run is being prepared
• CLAIMED: Run has been claimed by a worker
• INPROGRESS: Run is actively being executed
• SUCCEEDED: Run completed successfully
• FAILED: Run failed
• BLOCKED: Run is blocked (e.g., awaiting user input or approval)
• ERROR: Run encountered an error
• CANCELLED: Run was cancelled by user

Execution location of the run's latest execution, including ended executions:

• LOCAL: The latest execution is assigned to the machine running Warp or Oz, or to the same process as its cloud parent.
• REMOTE: The latest execution is remote or unassigned, or the run has no executions. This is not a liveness indicator. A newer execution can change the classification; the task's legacy worker assignment is ignored.

The prompt/instruction for the agent

The prompt exactly as it was submitted, without any extra context added by Warp. Includes any follow-up messages sent before the run started, separated by blank lines.

Timestamp when the run was created (RFC3339)

Timestamp when the run was last updated (RFC3339)

Total runtime as an ISO 8601 duration (e.g. "PT2M30S"), computed server-side from run executions.

Timestamp when the agent started working on the run (RFC3339)

Timestamp when the run last reached a terminal state (RFC3339). Null while the run is still active, and for terminal runs with no recorded finish time (runs executed locally, and runs that finished before finish times were recorded).

Source that created the run:

• LINEAR: Created from Linear integration
• API: Created via the Warp API
• MCP: Created through the Factory MCP server's send_task tool
• SLACK: Created from Slack integration
• TEAMS: Created from Microsoft Teams integration
• LOCAL: Created from local CLI/app
• SCHEDULED_AGENT: Created by a scheduled agent
• WEB_APP: Created from the Warp web app
• GITHUB_ACTION: Created from a GitHub action
• CLOUD_MODE: Created from a Cloud Mode
• CLI: Created from the CLI
• JIRA: Created from Jira integration
• SELF_IMPROVEMENT: Created by Warp's self-improvement pipeline
• GITHUB_WEBHOOK: Created from a GitHub webhook event
• GITLAB_WEBHOOK: Created from a GitLab webhook event
• AZURE_DEVOPS_WEBHOOK: Created from an Azure DevOps webhook event
• AUTOFIX: Created by Warp's autofix pipeline
• RUN_SCORER: Created by Warp's run-scoring judge
• ORCHESTRATION: Created as a child run by the orchestration layer (parent_run_id set)
• BENCHMARK_TRIAL: Created as a factory benchmark trial
• CREATE_BENCHMARK_TASK: Created by a Factory foreman authoring a benchmark task from a completed run
• CUSTOM_WEBHOOK: Created by a factory automation subscribed to a custom webhook source

UUID of the shared session (if available)

URL to view the agent session

URL to the run trigger (e.g. Slack thread, Linear issue, schedule)

UID of the factory whose agent executed the run. Absent for runs not executed by a factory agent.

UUID of the conversation associated with the run

UUID of the parent run that spawned this run

UUID of the top-level run of this run's orchestration tree. Equals run_id for a top-level run.

Whether the sandbox environment is currently running

Whether the run's type is eligible for cancellation via the API. State-independent: false for GitHub Action and local runs; true for all other run types (including self-hosted). Clients should still gate the control on the run's current state.

Whether a debug agent can currently be started inside this run's retained setup-failure session. Only true for a run that failed during environment setup, whose retained execution is still reachable, and whose debug window has not closed. See POST /agent/runs/{runId}/followups.