Delete a skill
DELETE /skills/{action_id}
DELETE
/skills/{action_id}
Delete a skill. Pre-flight GET enforces the target is a skill before forwarding the DELETE.
NOTE: this is a hard delete at the voice layer. Per the PRD lock, the skills surface does NOT do MCP-only soft-delete reference checks here — that logic lives in the MCP tool layer (where we can read workflow node references and refuse the delete).
Authorizations
Parameters
Path Parameters
action_id
required
Skill action_id.
string
Skill action_id.
Header Parameters
Responses
200
Successful Response
object
key
additional properties
any
422
Validation Error
object
detail
Array<object>
object
loc
required
Array
msg
required
string
type
required
string