Sign in

v1

latestOpenAPI 3.0.0Proprietary2026-07-132885152.8 KB
agent

Get run details

Retrieve detailed information about a specific agent run, including the full prompt, session link, and resolved configuration.

get/agent/runs/{runId}

Path parameters

runIdstring required

The unique identifier of the run

Response

Run details

run_idstring required

Unique identifier for the run

task_idstring required

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

titlestring required

Human-readable title for the run

state'QUEUED' | 'PENDING' | 'CLAIMED' | 'INPROGRESS' | 'SUCCEEDED' | 'FAILED' | 'BLOCKED' | 'ERROR' | 'CANCELLED' required

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'LOCAL' | 'REMOTE'

Where the run executed:

  • LOCAL: Executed in the user's local Oz environment
  • REMOTE: Executed by a remote/cloud worker
promptstring required

The prompt/instruction for the agent

created_atstring date-time required

Timestamp when the run was created (RFC3339)

updated_atstring date-time required

Timestamp when the run was last updated (RFC3339)

run_timestring duration

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

started_atstring date-time nullable

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

source'LINEAR' | 'API' | 'SLACK' | 'LOCAL' | 'SCHEDULED_AGENT' | 'WEB_APP' | 'GITHUB_ACTION' | 'CLOUD_MODE' | 'CLI'

Source that created the run:

  • LINEAR: Created from Linear integration
  • API: Created via the Warp API
  • SLACK: Created from Slack 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
session_idstring

UUID of the shared session (if available)

session_linkstring uri

URL to view the agent session

trigger_urlstring uri

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

conversation_idstring

UUID of the conversation associated with the run

parent_run_idstring

UUID of the parent run that spawned this run

is_sandbox_runningboolean

Whether the sandbox environment is currently running