Sweep 22 Sep 2026 · 17:19Z Build v2.1.280 501 read Stable v2.1.267 Latest v2.1.280 Next v2.1.280 Feeds RSS JSON llms.txt Unofficial
One change · api

Create Skill Version changed

api/beta/skills/versions/create

Nearest release: v2.1.251, published 2 hours before this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

Recorded here
Lines+26added
Lines−35removed
From line 114 where the diff opens
First seen 14 Aug 2026 this site's first read of the page
Recorded edits10to this page, all time

The whole hunk

from line 114, old and new numbered
/
lines
from line 114
114114 
115115## Returns
116116 
117- `id: string`
117- `BetaSkillVersion object`
118118 
119 Unique identifier for the skill version.
119 - `id: string`
120120 
121 The format and length of IDs may change over time.
121 Unique identifier for this Skill Version. The id addresses the version in
122 paths and pins it in references.
122123 
123- `created_at: string`
124 - `created_at: string`
124125 
125 ISO 8601 timestamp of when the skill version was created.
126 ISO 8601 timestamp of when the skill was created.
126127 
127- `description: string`
128 format: date-time
128129 
129 Description of the skill version.
130 - `description: string`
130131 
131 This is extracted from the SKILL.md file in the skill upload.
132 Description of the skill version.
132133 
133- `directory: string`
134 This is extracted from the SKILL.md file in the skill upload.
134135 
135 Directory name of the skill version.
136 - `name: string`
136137 
137 This is the top-level directory name that was extracted from the uploaded files.
138 The Skill's immutable kebab-case slug, set at creation from the first
139 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every
140 later upload must resolve to the same value. Also the top-level directory
141 of the Skill's mounted files and the base name of a downloaded archive.
138142 
139- `name: string`
143 - `skill_id: string`
140144 
141 Human-readable name of the skill version.
145 Unique identifier for the skill.
142146 
143 This is extracted from the SKILL.md file in the skill upload.
147 The format and length of IDs may change over time.
144148 
145- `skill_id: string`
149 - `type: "skill_version"`
146150 
147 Identifier for the skill that this version belongs to.
151 Object type.
148152 
149- `type: string`
153 For Skill Versions, this is always `"skill_version"`.
150154 
151 Object type.
155 default: skill_version
152156 
153 For Skill Versions, this is always `"skill_version"`.
154 
155 default: skill_version
156 
157- `version: string`
158 
159 Version identifier for the skill.
160 
161 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
162 
163157## Example
164158 
165159```bash
from line 160
166160curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
167161 -H 'Content-Type: multipart/form-data' \
168162 -H 'anthropic-version: 2023-06-01' \
169 -H 'anthropic-beta: skills-2025-10-02' \
170163 -H "X-Api-Key: $ANTHROPIC_API_KEY" \
171164 -F files='["Example data"]'
172165```
from line 168
175168 
176169```json
177170{
178 "id": "skillver_01JAbcdefghijklmnopqrstuvw",
171 "id": "id",
179172 "created_at": "2024-10-30T23:58:27.427722Z",
180 "description": "A custom skill for doing something useful",
181 "directory": "my-skill",
182 "name": "my-skill",
173 "description": "description",
174 "name": "name",
183175 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
184 "type": "type",
185 "version": "1759178010641129"
176 "type": "skill_version"
186177}
187178```
188179