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

Get a skill version

Retrieves a specific version of a skill. Use version to identify the version by its ID or request latest for the skill's most recent version. With the skills-2025-10-02 beta header, identify the version by its Unix epoch timestamp instead.

5 parameters
skill_idstringrequired
The unique identifier of the skill; the identifier format and length may change.
versionstringrequired
The skill version ID or the literal `latest`. 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 the skill version object with its creation timestamp, description, version ID, name, skill ID, and object type.
created_atstringrequired
ISO 8601 timestamp of when the skill was created.
descriptionstringrequired
Description of the skill version. This is extracted from the SKILL.md file in the skill upload.
idstringrequired
Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.
namestringrequired
The Skill's immutable kebab-case slug, set at creation from the first upload's SKILL.md frontmatter `name` (or its enclosing directory). Every later upload must resolve to the same value. Also the top-level directory of the Skill's mounted files and the base name of a downloaded archive.
skill_idstringrequired
Unique identifier for the skill. The format and length of IDs may change over time.
typestringrequired
Object type. For Skill Versions, this is always `"skill_version"`.
Default:skill_version
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 be a version ID or latest; with the skills-2025-10-02 beta header, use a Unix epoch timestamp for version.