Sign in
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

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

Changes

Changed in 9 of the 63 revisions of this API.117