Get a skill version
GET /v1/skills/{skill_id}/versions/{version}
Returns one version of a skill, or its newest version if you pass latest as version.
The key must have the skills:read capability. For what each capability allows, see Keys.
Path parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
skill_id | string | Yes | The ID of the skill, or a built-in skill’s slug. | |
version | string | Yes | The version’s ID, or latest. |
Response
Returns 200 with the skill version. For every field, see Skills.
{ "id": "b1c2d3e4-f5a6-4b7c-8d9e-0f1a2b3c4d5e", "type": "skill_version", "created_at": "2026-10-27T15:02:11.388Z", "description": "Summarize a pull request for reviewers.", "name": "pr-summary", "skill_id": "8b3f6c1e-2a4d-4f7b-9c1e-5d6a7b8c9d0e"}Errors
This endpoint can return these errors as well as the common errors.
| Status | error.type | Cause and fix |
|---|---|---|
| 404 | not_found_error | No skill with this ID or slug exists, the key’s owner can’t read it, or the version is not one of this skill’s. Check skill_id and version, and that the key’s owner can read the skill. |
Example
curl -sS "$CONTEXT_BASE_URL/v1/skills/8b3f6c1e-2a4d-4f7b-9c1e-5d6a7b8c9d0e/versions/latest" -H "x-api-key: $CONTEXT_API_KEY"version = client.beta.skills.versions.retrieve("latest", skill_id="8b3f6c1e-2a4d-4f7b-9c1e-5d6a7b8c9d0e")const version = await client.beta.skills.versions.retrieve("latest", { skill_id: "8b3f6c1e-2a4d-4f7b-9c1e-5d6a7b8c9d0e" })