Skip to main content
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

Authorization
string
header
required

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

Headers

Idempotency-Key
string

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 - 255

Path Parameters

run_id
string
required

Response

What was stopped.

run_id
string
required
status
string
required
cancelled
boolean
required

A stop was requested now (false: it had already finished)

kind
enum<string>
default:skill
Available options:
skill,
workflow
detail
string | null
stopped
Stopped · object[]

A workflow run: what it was running inside that was stopped too