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	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. Versions inherit the ownership of their Skill. See Identity ownership.

Example request

curl -X DELETE "https://api.qoder.com.cn/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 the query parameter `identity_id` (including 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 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 authorized scope.
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