v65

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0386234904.1 KB
agent

Get Runs V2

get/v1/runs

Query parameters

pageinteger
page_sizeinteger
statusRunStatus[] nullable
search_keystring nullable

Case-insensitive substring search (min 3 chars for trigram index).

Example:login_url

Case-insensitive substring search (min 3 chars for trigram index).

run_typeRunType[] nullable
workflow_permanent_idstring[] nullable

Filter to runs of these workflows (agents). Repeat the param to include multiple.

Filter to runs of these workflows (agents). Repeat the param to include multiple.

tagsstring[] nullable

Filter by run tags. Each term is a label (production), a group (env:*), or a group:label (env:prod). Repeat the param or comma-separate (?tags=env:prod,env:staging). AND across distinct terms, OR within a group's labels (?tags=customer:acme,env:prod,env:staging -> customer=acme AND env in (prod, staging)). A label term matches the value across any/no group. Matches current tag values only.

Filter by run tags. Each term is a label (production), a group (env:*), or a group:label (env:prod). Repeat the param or comma-separate (?tags=env:prod,env:staging). AND across distinct terms, OR within a group's labels (?tags=customer:acme,env:prod,env:staging -> customer=acme AND env in (prod, staging)). A label term matches the value across any/no group. Matches current tag values only.

Headers

x-api-keystring nullable

Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

Skyvern API key for authentication. API key can be found at https://app.skyvern.com/settings.

Response

Successful Response

task_run_idstring required
run_idstring required
task_run_typestring required
statusstring required
titlestring nullable
started_atstring date-time nullable
finished_atstring date-time nullable
created_atstring date-time required
workflow_permanent_idstring nullable
workflow_deletedboolean
script_runboolean
trigger_type'manual' | 'mcp' | 'api' | 'scheduled' | 'webhook'

How a workflow run was initiated.

  • manual: User clicked "Run" in the UI
  • mcp: First-party MCP client request
  • api: Direct API call to the run endpoint
  • scheduled: Triggered by a cron schedule
  • webhook: Triggered by an external system via the webhook endpoint