Delete Skill

DELETE/v1/skills/{skill_id}

Delete a Skill. A Skill referenced by any Agent version returns 409, even after that Agent is archived; disable it with Update Skill (status disabled) instead.

Path parameters

stringskill_idrequired

Skill ID (skl_ prefix).

curl -X DELETE https://api.sandbase.ai/v1/skills/skl_3c5e7a9b-1d4f-5a6c-8e2b-4d6f8a0c2e57 \
  -H "Authorization: Bearer $SANDBASE_API_KEY"

Response200 OK

{
  "id": "skl_3c5e7a9b-1d4f-5a6c-8e2b-4d6f8a0c2e57",
  "object": "skill.deleted",
  "deleted": true
}