Runs
Cancel a run
Stop a queued or running run you started.
POST
Cancel a run
Works for skill runs and workflow runs. Stopping a workflow run also stops what it is running inside; those are listed in
stopped. Rows already produced are kept, and credits already used stay charged.
cancelled is true when a stop was requested now, and false when the run had already finished (it is left as it is). kind says skill or workflow.
Only the person who started the run can stop it. Needs skills:invoke for a skill run, workflows:invoke for a workflow run. MCP tool: cancel_run.Authorizations
API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.
Headers
Any unique string (such as your order id). Resending the same request with the same key within 24 hours returns the first answer (with Idempotent-Replayed: true) and does nothing twice; the same key with a different request is a 422 idempotency_key_reused.
Required string length:
1 - 255Path Parameters
Response
What was stopped.

