Skip to main content
GET
List workflow runs
Filter with status (pending, running, completed, failed, cancelled), source (api, mcp, app, schedule, …), since, and until. Page with limit (1–100, default 25) and cursor. Each item has run_id, status, source, times, outputs_count, credits_charged, credits_refunded, failure_class, error, and status_url. For the outputs, call Get a run. Needs workflows:read. MCP tool: list_workflow_runs.

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Path Parameters

slug
string
required

Query Parameters

status
string | null

One of: pending, running, completed, failed, cancelled.

source
string | null

api, mcp, app, schedule ...

Maximum string length: 20
since
string<date-time> | null

Runs created at or after (ISO 8601).

until
string<date-time> | null

Runs created before (ISO 8601).

limit
integer
default:25

Items per page, 1–100.

Required range: 1 <= x <= 100
cursor
string | null

Response

A page of runs.

runs
WorkflowRunSummary · object[]
required
has_more
boolean
required
read-only

True when there is a next page (next_cursor is not null).

next_cursor
string | null

Pass as ?cursor= for the next page; null on the last page.