Anthropic API (unofficial showcase)
DELETE/v1/skills/{skill_id}/versions/{version}

Delete a skill version

Deletes a specific version of a skill. Supply the skill and version identifiers to select the version to remove. The response confirms the deletion with the deleted version's ID.

5 parameters
skill_idstringrequired
The unique identifier of the skill; the identifier format and length may change.
versionstringrequired
The ID of the skill version to delete. Requests using the `skills-2025-10-02` beta header identify the version by its Unix epoch timestamp.
anthropic-versionstringoptional
The version of the Claude API to use for this request.
x-api-keystringoptional
Your API key for authenticating the request; the key is scoped to a Workspace.
anthropic-workspace-idstringoptional
The Workspace ID to use when the credential can act on multiple Workspaces. If sent with a Workspace-specific credential, it must match that credential's Workspace.

17 status codes
200Returns a deletion confirmation containing the deleted skill version's ID and the `skill_version_deleted` object type.
idstringrequired
Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.
typestringrequired
Deleted object type. For Skill Versions, this is always `"skill_version_deleted"`.
Default:skill_version_deleted
400Returned when the request contains an invalid argument.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
401Returned when the request does not have valid authentication credentials.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
403Returned when the caller does not have permission to perform the operation.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
404Returned when a requested entity is not found.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
408Returned when the deadline expires before the operation completes.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
409Returned when a concurrency issue aborts the operation.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
412Returned when the operation is rejected because the system is not in the required state.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
413Returned when the operation is attempted beyond a valid range.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
429Returned when a resource is exhausted, such as when the request is rate limited.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
431Returned when the request metadata is too large.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
499Returned when the client cancels the operation.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
500Returned when an internal server error occurs.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
501Returned when the operation is not implemented or supported.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
503Returned when the service is unavailable.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
504Returned when an upstream service does not respond in time.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error
529Returned when the service is temporarily overloaded.
errorobjectrequired
request_idstringrequired
Default:null
typestringrequired
Default:error

Error handling

A 400 is returned for an invalid argument, a 401 when authentication credentials are invalid, and a 403 when the caller lacks permission. A 404 indicates that a requested entity was not found; a 408 indicates that the deadline expired; a 409 indicates a concurrency issue; a 412 indicates that a required system state was not met; and a 413 indicates that the operation exceeded a valid range. A 429 indicates resource exhaustion, a 431 that request metadata was too large, a 499 that the client cancelled the operation, a 500 an internal error, a 501 an unsupported operation, a 503 that the service is unavailable, a 504 an upstream timeout, and a 529 temporary service overload. The skill_id path parameter must identify the skill, and the version path parameter must identify the version to delete.