GET/v1/skills/{skill_id}/versions

List versions of a skill

Lists versions of a specific skill. Use page to continue from the previous response's next_page token and limit to control the number of results per page.

6 parameters
skill_idstringrequired
The unique identifier of the skill whose versions to list; the identifier format and length may change.
pagestringoptional
The `next_page` token from the previous response. Omit it to start with the first page.
limitintegeroptional
The number of results per page, from 1 to 1000. Defaults to 20 when omitted.
Default:20
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 `data` array of skill version objects and a `next_page` token; `next_page` is null when no further results are available.
dataarray<SkillVersion>required
List of skills.
next_pagestringrequired
Token for fetching the next page of results. If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.
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, limit must be between 1 and 1000, and page must be a next_page token from a previous response.