Runs
Get a run
Any run, skill or workflow: its status, and the result once it has finished.
GET
Get a run
Skill run ids start with
run_. Anything else is looked up as a workflow run.
While the run is going, status is queued, pending, or running. Once it ends:
- A skill run has its rows in
rows, pluscount, cost, version, and the trust fields. - A workflow run has
kind: "workflow",outputs, a per-step summary insteps, cost, andfailure_class.
runs:read for a skill run, workflows:read for a workflow run.
The older GET /v1/workflow-runs/{run_id} still works for workflow runs.
MCP tool: get_run, which pages the rows. See Run results.Authorizations
API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.
Path Parameters
Response
The run.
GET /v1/runs/{run_id}: status while it runs, the result once it is done.
Why the run came back short, and what a hint could say to fix it (POST /v1/skills/{slug}/improve).

