Skip to main content
GET
List skill runs
Filter with status (comma-separated: queued, running, success, partial, failed, cancelled) and since. Page with limit (1–100, default 50) and cursor. Each item has run_id, status, start and finish times, rows, credits, failure_class, tier_used, recipe_version, error, and run_url. For the rows themselves, call Get a run. The skill’s owner and workspace see every run. Someone running a public skill sees only their own. Needs runs:read. MCP tool: list_skill_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

Comma-separated: queued,running,success,partial,failed,cancelled

since
string<date-time> | null

Only runs started at or after this time

limit
integer
default:50

Items per page, 1–100.

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

Response

A page of runs.

runs
SkillRunItem · 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.