from line 1
1---
2title: Create Skill Version
3url: https://platform.claude.com/docs/en/api/beta/skills/versions/create
4---
1# Create Skill Version
52
6## Create Skill Version
3**POST** `/v1/skills/{skill_id}/versions`
74
8**post** `/v1/skills/{skill_id}/versions`
9
105Create Skill Version
116
12### Path Parameters
7## Path parameters
138
149- `skill_id: string`
1510
from line 12
1712
1813 The format and length of IDs may change over time.
1914
20### Header Parameters
15## Headers
2116
2217- `"anthropic-beta": optional array of AnthropicBeta`
2318
from line 90
9590
9691 - `"mid-conversation-tool-changes-2026-07-01"`
9792
98### Returns
93## Body parameters (form-data)
9994
95- `files: array of string`
96
97 Files to upload for the skill.
98
99 All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.
100
101## Returns
102
100103- `id: string`
101104
102105 Unique identifier for the skill version.
from line 138
135138
136139 For Skill Versions, this is always `"skill_version"`.
137140
141 default: skill_version
142
138143- `version: string`
139144
140145 Version identifier for the skill.
from line 146
141146
142147 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
143148
144### Example
149## Example
145150
146```http
151```bash
147152curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
148153 -H 'Content-Type: multipart/form-data' \
149154 -H 'anthropic-version: 2023-06-01' \
from line 157
152157 -F files='["Example data"]'
153158```
154159
155#### Response
160### Response (200)
156161
157162```json
158163{
No line in this hunk matches that.