One change
Skills
api/beta/skills
Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.
api/beta/skills Changed · +126 / -245 lines
### Headers ### Body parameters (form-data) #### Response (200) ### Query parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ### Path parameters ### Headers #### Response (200) ## Domain types ## Skills › Versions ### Create Skill Version #### Path parameters #### Headers #### Body parameters (form-data) #### Returns #### Example ##### Response (200) ### List Skill Versions #### Path parameters #### Query parameters #### Headers #### Returns #### Example ##### Response (200) ### Download Skill Version Content #### Path parameters #### Headers #### Example ### Get Skill Version #### Path parameters #### Headers #### Returns #### Example ##### Response (200) ### Delete Skill Version #### Path parameters #### Headers #### Returns #### Example ##### Response (200) ### Header Parameters #### Response ### Query Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ### Path Parameters ### Header Parameters #### Response ## Domain Types # Versions ## Create Skill Version ### Path Parameters ### Header Parameters #### Response ## List Skill Versions ### Path Parameters ### Query Parameters ### Header Parameters #### Response ## Download Skill Version Content ### Path Parameters ### Header Parameters ## Get Skill Version ### Path Parameters ### Header Parameters #### Response ## Delete Skill Version ### Path Parameters ### Header Parameters #### Response ## Domain Types ### Version Create Response ### Version List Response ### Version Retrieve Response ### Version Delete Response
from line 1
---- -title: Skills -url: https://platform.claude.com/docs/en/api/beta/skills ---- - # Skills ## Create Skill -**post** `/v1/skills` +**POST** `/v1/skills` Create Skill -### Header Parameters +### Headers - `"anthropic-beta": optional array of AnthropicBeta`
from line 84
- `"mid-conversation-tool-changes-2026-07-01"` +### Body parameters (form-data) + +- `files: array of string` + + Files to upload for the skill. + + All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory. + +- `display_title: optional string or null` + + Display title for the skill. + + This is a human-readable label that is not included in the prompt sent to the model. + ### Returns - `id: string`
from line 137
For Skills, this is always `"skill"`. + default: skill + - `updated_at: string` ISO 8601 timestamp of when the skill was last updated.
from line 145
### Example -```http +```bash curl https://api.anthropic.com/v1/skills \ -H 'Content-Type: multipart/form-data' \ -H 'anthropic-version: 2023-06-01' \
from line 154
-F files='["Example data"]' ``` -#### Response +#### Response (200) ```json {
from line 170
## List Skills -**get** `/v1/skills` +**GET** `/v1/skills` List Skills -### Query Parameters +### Query parameters - `limit: optional number`
from line 182
Maximum value is 100. Defaults to 20. + default: 20 + - `page: optional string` Pagination token for fetching a specific page of results.
from line 199
* `"custom"`: only return user-created skills * `"anthropic"`: only return Anthropic-created skills -### Header Parameters +### Headers - `"anthropic-beta": optional array of AnthropicBeta`
from line 279
### Returns -- `data: array of object { id, created_at, display_title, 4 more }` +- `data: array of object` List of skills.
from line 320
For Skills, this is always `"skill"`. + default: skill + - `updated_at: string` ISO 8601 timestamp of when the skill was last updated.
from line 340
### Example -```http +```bash curl https://api.anthropic.com/v1/skills \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \
from line 347
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +#### Response (200) ```json {
from line 369
## Get Skill -**get** `/v1/skills/{skill_id}` +**GET** `/v1/skills/{skill_id}` Get Skill -### Path Parameters +### Path parameters - `skill_id: string`
from line 381
The format and length of IDs may change over time. -### Header Parameters +### Headers - `"anthropic-beta": optional array of AnthropicBeta`
from line 498
For Skills, this is always `"skill"`. + default: skill + - `updated_at: string` ISO 8601 timestamp of when the skill was last updated.
from line 506
### Example -```http +```bash curl https://api.anthropic.com/v1/skills/$SKILL_ID \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \
from line 513
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +#### Response (200) ```json {
from line 529
## Delete Skill -**delete** `/v1/skills/{skill_id}` +**DELETE** `/v1/skills/{skill_id}` Delete Skill -### Path Parameters +### Path parameters - `skill_id: string`
from line 541
The format and length of IDs may change over time. -### Header Parameters +### Headers - `"anthropic-beta": optional array of AnthropicBeta`
from line 633
For Skills, this is always `"skill_deleted"`. + default: skill_deleted + ### Example -```http +```bash curl https://api.anthropic.com/v1/skills/$SKILL_ID \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \
from line 645
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +#### Response (200) ```json {
from line 654
} ``` -## Domain Types +## Domain types ### Skill Create Response -- `SkillCreateResponse object { id, created_at, display_title, 4 more }` +- `SkillCreateResponse object` - `id: string`
from line 697
For Skills, this is always `"skill"`. + default: skill + - `updated_at: string` ISO 8601 timestamp of when the skill was last updated.
from line 705
### Skill List Response -- `SkillListResponse object { id, created_at, display_title, 4 more }` +- `SkillListResponse object` - `id: string`
from line 744
For Skills, this is always `"skill"`. + default: skill + - `updated_at: string` ISO 8601 timestamp of when the skill was last updated.
from line 752
### Skill Retrieve Response -- `SkillRetrieveResponse object { id, created_at, display_title, 4 more }` +- `SkillRetrieveResponse object` - `id: string`
from line 791
For Skills, this is always `"skill"`. + default: skill + - `updated_at: string` ISO 8601 timestamp of when the skill was last updated.
from line 799
### Skill Delete Response -- `SkillDeleteResponse object { id, type }` +- `SkillDeleteResponse object` - `id: string`
from line 813
For Skills, this is always `"skill_deleted"`. -# Versions + default: skill_deleted -## Create Skill Version +## Skills › Versions -**post** `/v1/skills/{skill_id}/versions` +### Create Skill Version +**POST** `/v1/skills/{skill_id}/versions` + Create Skill Version -### Path Parameters +#### Path parameters - `skill_id: string`
from line 831
The format and length of IDs may change over time. -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
from line 909
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +#### Body parameters (form-data) +- `files: array of string` + + Files to upload for the skill. + + All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory. + +#### Returns + - `id: string` Unique identifier for the skill version.
from line 957
For Skill Versions, this is always `"skill_version"`. + default: skill_version + - `version: string` Version identifier for the skill.
from line 965
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). -### Example +#### Example -```http +```bash curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -H 'Content-Type: multipart/form-data' \ -H 'anthropic-version: 2023-06-01' \
from line 976
-F files='["Example data"]' ``` -#### Response +##### Response (200) ```json {
from line 991
} ``` -## List Skill Versions +### List Skill Versions -**get** `/v1/skills/{skill_id}/versions` +**GET** `/v1/skills/{skill_id}/versions` List Skill Versions -### Path Parameters +#### Path parameters - `skill_id: string`
from line 1005
The format and length of IDs may change over time. -### Query Parameters +#### Query parameters - `limit: optional number`
from line 1017
Optionally set to the `next_page` token from the previous response. -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
from line 1095
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +#### Returns -- `data: array of object { id, created_at, description, 5 more }` +- `data: array of object` List of skill versions.
from line 1139
For Skill Versions, this is always `"skill_version"`. + default: skill_version + - `version: string` Version identifier for the skill.
from line 1155
Token to provide in as `page` in the subsequent request to retrieve the next page of data. -### Example +#### Example -```http +```bash curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \
from line 1164
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +##### Response (200) ```json {
from line 1185
} ``` -## Download Skill Version Content +### Download Skill Version Content -**get** `/v1/skills/{skill_id}/versions/{version}/content` +**GET** `/v1/skills/{skill_id}/versions/{version}/content` Download a skill version's content as a zip archive. -### Path Parameters +#### Path parameters - `skill_id: string`
from line 1205
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
from line 1283
- `"mid-conversation-tool-changes-2026-07-01"` -### Example +#### Example -```http +```bash curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION/content \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \
from line 1292
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -## Get Skill Version +### Get Skill Version -**get** `/v1/skills/{skill_id}/versions/{version}` +**GET** `/v1/skills/{skill_id}/versions/{version}` Get Skill Version -### Path Parameters +#### Path parameters - `skill_id: string`
from line 1312
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
from line 1390
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +#### Returns - `id: string`
from line 1430
For Skill Versions, this is always `"skill_version"`. + default: skill_version + - `version: string` Version identifier for the skill.
from line 1438
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). -### Example +#### Example -```http +```bash curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -H 'anthropic-version: 2023-06-01' \ -H 'anthropic-beta: skills-2025-10-02' \
from line 1447
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +##### Response (200) ```json {
from line 1462
} ``` -## Delete Skill Version +### Delete Skill Version -**delete** `/v1/skills/{skill_id}/versions/{version}` +**DELETE** `/v1/skills/{skill_id}/versions/{version}` Delete Skill Version -### Path Parameters +#### Path parameters - `skill_id: string`
from line 1482
Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). -### Header Parameters +#### Headers - `"anthropic-beta": optional array of AnthropicBeta`
from line 1560
- `"mid-conversation-tool-changes-2026-07-01"` -### Returns +#### Returns - `id: string`
from line 1574
For Skill Versions, this is always `"skill_version_deleted"`. -### Example + default: skill_version_deleted -```http +#### Example + +```bash curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \ -X DELETE \ -H 'anthropic-version: 2023-06-01' \
from line 1586
-H "X-Api-Key: $ANTHROPIC_API_KEY" ``` -#### Response +##### Response (200) ```json {
from line 1594
"type": "type" } ``` - -## Domain Types - -### Version Create Response - -- `VersionCreateResponse object { id, created_at, description, 5 more }` - - - `id: string` - - Unique identifier for the skill version. - - The format and length of IDs may change over time. - - - `created_at: string` - - ISO 8601 timestamp of when the skill version was created. - - - `description: string` - - Description of the skill version. - - This is extracted from the SKILL.md file in the skill upload. - - - `directory: string` - - Directory name of the skill version. - - This is the top-level directory name that was extracted from the uploaded files. - - - `name: string` - - Human-readable name of the skill version. - - This is extracted from the SKILL.md file in the skill upload. - - - `skill_id: string` - - Identifier for the skill that this version belongs to. - - - `type: string` - - Object type. - - For Skill Versions, this is always `"skill_version"`. - - - `version: string` - - Version identifier for the skill. - - Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - -### Version List Response - -- `VersionListResponse object { id, created_at, description, 5 more }` - - - `id: string` - - Unique identifier for the skill version. - - The format and length of IDs may change over time. - - - `created_at: string` - - ISO 8601 timestamp of when the skill version was created. - - - `description: string` - - Description of the skill version. - - This is extracted from the SKILL.md file in the skill upload. - - - `directory: string` - - Directory name of the skill version. - - This is the top-level directory name that was extracted from the uploaded files. - - - `name: string` - - Human-readable name of the skill version. - - This is extracted from the SKILL.md file in the skill upload. - - - `skill_id: string` - - Identifier for the skill that this version belongs to. - - - `type: string` - - Object type. - - For Skill Versions, this is always `"skill_version"`. - - - `version: string` - - Version identifier for the skill. - - Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - -### Version Retrieve Response - -- `VersionRetrieveResponse object { id, created_at, description, 5 more }` - - - `id: string` - - Unique identifier for the skill version. - - The format and length of IDs may change over time. - - - `created_at: string` - - ISO 8601 timestamp of when the skill version was created. - - - `description: string` - - Description of the skill version. - - This is extracted from the SKILL.md file in the skill upload. - - - `directory: string` - - Directory name of the skill version. - - This is the top-level directory name that was extracted from the uploaded files. - - - `name: string` - - Human-readable name of the skill version. - - This is extracted from the SKILL.md file in the skill upload. - - - `skill_id: string` - - Identifier for the skill that this version belongs to. - - - `type: string` - - Object type. - - For Skill Versions, this is always `"skill_version"`. - - - `version: string` - - Version identifier for the skill. - - Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - -### Version Delete Response - -- `VersionDeleteResponse object { id, type }` - - - `id: string` - - Version identifier for the skill. - - Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129"). - - - `type: string` - - Deleted object type. - - For Skill Versions, this is always `"skill_version_deleted"`.