Skip to main content
DELETE
Delete a skill
The skill’s runs stay in run history (your billing history), and its schedule stops. This cannot be undone. If a workflow uses the skill, you get 409 with detail.workflows listing them. Remove the skill from those workflows, or send ?force=true: the skill is deleted and those workflows’ step fails until you point it at another skill. The response lists them in workflows_detached. Owner only. Needs skills:write. MCP tool: delete_skill.

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

force
boolean
default:false

Delete even though workflows use it (their step then fails)

Response

Deleted.

slug
string
required
deleted
boolean
default:true
unscheduled
boolean
default:false
workflows_detached
WorkflowRef · object[]

Workflows that used the skill (?force=true); their step now fails