The whole hunk
from line 16, old and new numbered
/
lines
from line 16
1616
1717- `limit: optional number`
1818
19 Number of items to return per page.
19 Number of results to return per page.
2020
21 Defaults to `20`. Ranges from `1` to `1000`.
21 Ranges from `1` to `1000`. Defaults to `20`.
2222
23 default: 20, minimum: 1, maximum: 1000
24
2325- `page: optional string`
2426
2527 Optionally set to the `next_page` token from the previous response.
from line 120
118120
119121## Returns
120122
121- `data: array of object`
123- `data: array of BetaSkillVersion`
122124
123 List of skill versions.
125 List of skills.
124126
125127 - `id: string`
126128
127 Unique identifier for the skill version.
129 Unique identifier for this Skill Version. The id addresses the version in
130 paths and pins it in references.
128131
129 The format and length of IDs may change over time.
130
131132 - `created_at: string`
132133
133 ISO 8601 timestamp of when the skill version was created.
134 ISO 8601 timestamp of when the skill was created.
134135
136 format: date-time
137
135138 - `description: string`
136139
137140 Description of the skill version.
from line 141
138141
139142 This is extracted from the SKILL.md file in the skill upload.
140143
141 - `directory: string`
142
143 Directory name of the skill version.
144
145 This is the top-level directory name that was extracted from the uploaded files.
146
147144 - `name: string`
148145
149 Human-readable name of the skill version.
146 The Skill's immutable kebab-case slug, set at creation from the first
147 upload's SKILL.md frontmatter `name` (or its enclosing directory). Every
148 later upload must resolve to the same value. Also the top-level directory
149 of the Skill's mounted files and the base name of a downloaded archive.
150150
151 This is extracted from the SKILL.md file in the skill upload.
152
153151 - `skill_id: string`
154152
155 Identifier for the skill that this version belongs to.
153 Unique identifier for the skill.
156154
157 - `type: string`
155 The format and length of IDs may change over time.
158156
157 - `type: "skill_version"`
158
159159 Object type.
160160
161161 For Skill Versions, this is always `"skill_version"`.
from line 162
162162
163163 default: skill_version
164164
165 - `version: string`
166
167 Version identifier for the skill.
168
169 Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").
170
171- `has_more: boolean`
172
173 Indicates if there are more results in the requested page direction.
174
175165- `next_page: string or null`
176166
177 Token to provide in as `page` in the subsequent request to retrieve the next page of data.
167 Token for fetching the next page of results.
178168
169 If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.
170
179171## Example
180172
181173```bash
182174curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \
183175 -H 'anthropic-version: 2023-06-01' \
184 -H 'anthropic-beta: skills-2025-10-02' \
185176 -H "X-Api-Key: $ANTHROPIC_API_KEY"
186177```
187178
from line 182
191182{
192183 "data": [
193184 {
194 "id": "skillver_01JAbcdefghijklmnopqrstuvw",
185 "id": "id",
195186 "created_at": "2024-10-30T23:58:27.427722Z",
196 "description": "A custom skill for doing something useful",
197 "directory": "my-skill",
198 "name": "my-skill",
187 "description": "description",
188 "name": "name",
199189 "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
200 "type": "type",
201 "version": "1759178010641129"
190 "type": "skill_version"
202191 }
203192 ],
204 "has_more": true,
205 "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo="
193 "next_page": "next_page"
206194}
207195```
208196