Sign in

v1

latestOpenAPI 3.0.0Proprietary2026-07-132885152.8 KB
agent

List agent runs

Retrieve a paginated list of agent runs with optional filtering. Results default to sort_by=updated_at and sort_order=desc.

get/agent/runs

Query parameters

limitinteger

Maximum number of runs to return

cursorstring

Pagination cursor from previous response

sort_by'updated_at' | 'created_at' | 'title' | 'agent'

Sort field for results.

  • updated_at: Sort by last update timestamp (default)
  • created_at: Sort by creation timestamp
  • title: Sort alphabetically by run title
  • agent: Sort alphabetically by skill. Runs without a skill are grouped last.
sort_order'asc' | 'desc'

Sort direction

stateRunState[]

Filter by run state. Can be specified multiple times to match any of the given states.

namestring

Filter by agent config name

model_idstring

Filter by model ID

creatorstring

Filter by creator UID (user or service account)

executorstring

Filter by the user or agent that executed the run. This will often be the same as the creator, but not always: users may delegate tasks to agents.

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

Filter by run source type

execution_location'LOCAL' | 'REMOTE'

Where the run executed:

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

Filter by where the run executed

created_afterstring date-time

Filter runs created after this timestamp (RFC3339 format)

created_beforestring date-time

Filter runs created before this timestamp (RFC3339 format)

updated_afterstring date-time

Filter runs updated after this timestamp (RFC3339 format)

environment_idstring

Filter runs by environment ID

skillstring

Filter runs by skill spec (e.g., "owner/repo:path/to/SKILL.md"). Alias for skill_spec.

skill_specstring

Filter runs by skill spec (e.g., "owner/repo:path/to/SKILL.md")

schedule_idstring

Filter runs by the scheduled agent ID that created them

ancestor_run_idstring

Filter runs by ancestor run ID. The referenced run must exist and be accessible to the caller.

artifact_type'PLAN' | 'PULL_REQUEST' | 'SCREENSHOT' | 'FILE'

Filter runs by artifact type

qstring

Fuzzy search query across run title, prompt, and skill_spec

Response

List of runs