Delete a Skill - Qoder CN

Path

DELETE /api/v1/forward/skills/{id}

Header	Required	Description
`Authorization`	Yes	`Bearer <PAT or SAT>`

Checks Template references before deletion. If unreferenced, the Skill is deleted and no longer appears in default listings.

Parameter	Type	Required	Description
`id`	string	Yes	Skill ID.

Parameter	Type	Required	Description
`identity_id`	string	No	Use only when operating on Identity-owned resources. A PAT can explicitly supply this query parameter; omitting it uses administrator scope. SAT ownership is determined by the credential. Explicitly supplying this parameter with any SAT (including an empty value) returns HTTP 400. See Identity ownership.

curl -X DELETE "https://api.qoder.com.cn/api/v1/forward/skills/skill_xxx" \
  -H "Authorization: Bearer $QODER_ACCESS_TOKEN"

{
  "id": "skill_xxx",
  "type": "skill_deleted",
  "deleted": true
}

Field	Type	Description
`id`	string	ID of the deleted resource.
`type`	string	Deletion result type.
`deleted`	boolean	Whether the resource was deleted.

HTTP	Type	Trigger
400	`invalid_request_error`	The request body, path parameters, or query parameters are invalid; this includes explicitly supplying the query parameter `identity_id` with any SAT, even with an empty value.
401	`authentication_error`	The authentication token is missing or invalid.
403	`permission_error`	An Owner mismatch occurs in administrator scope, or a downstream service denies access.
404	`not_found_error`	The Skill does not exist, is not registered, or is not visible in the current Identity scope; the Identity specified by the PAT is invalid, disabled, deleted, or outside the caller's authorized scope.
409	`conflict_error`	The idempotency key conflicts, create recovery requires manual intervention, or the resource is still referenced during deletion.
429	`rate_limit_error`	Upload capacity is insufficient.
500/502/503	`api_error`	Forward or a dependent service failed.