Delete a Skill Version

Description

Soft-deletes a version of the specified Skill. The deleted version no longer appears in the version list. If it was the latest version, latest_version automatically points to the next-newest active version, or becomes null when no versions remain.

Path

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

Request headers

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

Path parameters

Parameter	Type	Required	Description
`id`	string	Yes	Skill ID.
`version`	string	Yes	Version number. Accepts a 16-digit Unix microsecond timestamp or a legacy incremental counter during migration. The literal `latest` is not supported and returns 400. See Legacy version-number compatibility.

Query parameters

Parameter	Type	Required	Description
`identity_id`	string	No	For Identity-owned resources only. PATs may supply this query parameter; omitting it uses the administrator scope. SAT ownership is determined by the credential; any SAT (including Admin SAT) explicitly supplying this parameter, even with an empty value, receives HTTP 400. Versions inherit ownership from their Skill. See Identity ownership.

Example request

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

Example response

HTTP 200 OK

{
  "id": "1786973491821648",
  "type": "skill_version_deleted",
  "deleted": true
}

Response fields

Field	Type	Description
`id`	string	Deleted version number.
`type`	string	Always `"skill_version_deleted"`
`deleted`	boolean	Always `true`

Side effects

If the deleted version is the Skill's latest_version, the service automatically points latest_version to the remaining active version with the most recent created_at.
If no active versions remain, latest_version becomes null.
Deletion is soft: the deleted version's status becomes deleted, and the stored entity is not immediately destroyed.

Errors

HTTP	Type	Trigger
400	`invalid_request_error`	The version format is invalid, such as `latest` or a nonnumeric string, or any SAT explicitly supplies query `identity_id` (even with an empty value).
401	`authentication_error`	The authentication token is missing or invalid.
403	`permission_error`	An owner mismatch occurs in the administrator scope, or a downstream service denies access.
404	`not_found_error`	The Skill or version does not exist or is not visible in the current Identity scope; the Identity specified by the PAT is invalid, disabled, deleted, or outside the caller's ownership.
409	`conflict_error`	The resource state conflicts with the operation, for example when the Skill is archived.
500/502/503	`api_error`	Forward or a dependent service failed.

​Description

​Path

​Request headers

​Path parameters

​Query parameters

​Example request

​Example response

​Response fields

​Side effects

​Errors