Repository Public
1---2title: Get Skill Version3url: https://platform.claude.com/docs/en/api/beta/skills/versions/retrieve4---56# Get Skill Version78**GET** `/v1/skills/{skill_id}/versions/{version}`910Get Skill Version1112## Path parameters1314- `skill_id: string`1516 Unique identifier for the skill.1718 The format and length of IDs may change over time.1920- `version: string`2122 Identifies the skill version: a version ID, or the literal `latest` for the skill's most recent version.2324 Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").2526## Headers2728- `"anthropic-beta": optional array of AnthropicBeta`2930 Optional header to specify the beta version(s) you want to use.3132 - `string`3334 - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 43 more`3536 - `"message-batches-2024-09-24"`3738 - `"prompt-caching-2024-07-31"`3940 - `"computer-use-2024-10-22"`4142 - `"computer-use-2025-01-24"`4344 - `"pdfs-2024-09-25"`4546 - `"token-counting-2024-11-01"`4748 - `"token-efficient-tools-2025-02-19"`4950 - `"output-128k-2025-02-19"`5152 - `"files-api-2025-04-14"`5354 - `"mcp-client-2025-04-04"`5556 - `"mcp-client-2025-11-20"`5758 - `"dev-full-thinking-2025-05-14"`5960 - `"interleaved-thinking-2025-05-14"`6162 - `"code-execution-2025-05-22"`6364 - `"extended-cache-ttl-2025-04-11"`6566 - `"context-1m-2025-08-07"`6768 - `"context-management-2025-06-27"`6970 - `"model-context-window-exceeded-2025-08-26"`7172 - `"skills-2025-10-02"`7374 - `"fast-mode-2026-02-01"`7576 - `"output-300k-2026-03-24"`7778 - `"user-profiles-2026-03-24"`7980 - `"user-profiles-2026-08-18"`8182 - `"user-profiles-2026-09-04"`8384 - `"advisor-tool-2026-03-01"`8586 - `"managed-agents-2026-04-01"`8788 - `"cache-diagnosis-2026-04-07"`8990 - `"dreaming-2026-04-21"`9192 - `"thinking-token-count-2026-05-13"`9394 - `"server-side-fallback-2026-06-01"`9596 - `"server-side-fallback-2026-07-01"`9798 - `"fallback-credit-2026-06-01"`99100 - `"fallback-credit-2026-07-01"`101102 - `"agent-memory-2026-07-22"`103104 - `"mid-conversation-tool-changes-2026-07-01"`105106 - `"compact-2026-01-12"`107108 - `"computer-use-2025-11-24"`109110 - `"mcp-tunnels-2026-06-22"`111112 - `"structured-outputs-2025-11-13"`113114 - `"task-budgets-2026-03-13"`115116 - `"thinking-display-updates-2026-08-18"`117118 - `"ce-user-management-2026-07-13"`119120 - `"mid-conversation-output-config-2026-07-01"`121122 - `"thinking-binding-controls-2026-08-01"`123124 - `"mid-conversation-system-clear-at-2026-08-21"`125126 - `"compact-2026-09-04"`127128- `"anthropic-workspace-id": optional string`129130## Returns131132- `BetaSkillVersion object`133134 - `type: "skill_version"`135136 Object type.137138 For Skill Versions, this is always `"skill_version"`.139140 default: skill_version141142 - `id: string`143144 Unique identifier for this Skill Version. The id addresses the version in145 paths and pins it in references.146147 - `created_at: string`148149 ISO 8601 timestamp of when the skill was created.150151 format: date-time152153 - `description: string`154155 Description of the skill version.156157 This is extracted from the SKILL.md file in the skill upload.158159 - `name: string`160161 The Skill's immutable kebab-case slug, set at creation from the first162 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every163 later upload must resolve to the same value. Also the top-level directory164 of the Skill's mounted files and the base name of a downloaded archive.165166 - `skill_id: string`167168 Unique identifier for the skill.169170 The format and length of IDs may change over time.171172## Example173174```bash175curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \176 -H 'anthropic-version: 2023-06-01' \177 -H "X-Api-Key: $ANTHROPIC_API_KEY"178```179180### Response (200)181182```json183{184 "id": "id",185 "created_at": "2024-10-30T23:58:27.427722Z",186 "description": "description",187 "name": "name",188 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",189 "type": "skill_version"190}191```192