Skip to main content
DELETE
/
api
/
v1
/
tenants
/
{tenantId}
/
skills
/
{skillId}
Delete skill
curl --request DELETE \
  --url https://api.example.com/api/v1/tenants/{tenantId}/skills/{skillId} \
  --header 'Authorization: <authorization>'

​
Overview

Permanently deletes a custom skill. Once deleted, the skill can no longer be invoked by AI agents. This action cannot be undone — consider disabling the skill instead if you may need it later.
Skills use a non-standard base path: /api/v1/tenants/{tenantId}/skills — not /v1/. This is a dedicated module with its own routing prefix.
Required role: admin

​
Request headers

​
Authorization
string
required
JWT Bearer token. Format: Bearer <your-jwt>.

​
Path parameters

​
tenantId
string
required
Your tenant identifier. Example: ten_EXAMPLE_ABC123.
​
skillId
string
required
The skill identifier. Example: skl_01HX9VTPQR3KF8MZWBYD5N6JCE.

​
Response

Returns 204 No Content on success. No response body.

​
Error responses

StatusError codeDescription
401unauthorizedMissing or invalid JWT
403forbiddenCaller lacks admin role
404skill_not_foundNo skill with the given ID
409skill_in_useSkill is referenced by an active trigger and cannot be deleted

​
Examples

curl https://api.causeflow.ai/api/v1/tenants/ten_EXAMPLE_ABC123/skills/skl_01HX9VTPQR3KF8MZWBYD5N6JCE \
  -X DELETE \
  -H "Authorization: Bearer eyJhbGc..."

Update skill

Disable a skill without deleting it

List skills

View all remaining skills