SPB Git

Repository Public

versions.md 8.5 KB 413 lines markdown

1---2title: Versions3url: https://platform.claude.com/docs/en/api/skills/versions4---56# Versions78## Create Skill Version910**POST** `/v1/skills/{skill_id}/versions`1112Create Skill Version1314### Path parameters1516- `skill_id: string`1718  Unique identifier for the skill.1920  The format and length of IDs may change over time.2122### Headers2324- `"anthropic-workspace-id": optional string`2526### Body parameters (form-data)2728- `files: array of string`2930  Files to upload for the skill.3132  All files must be in the same top-level directory and must include a SKILL.md file at the root of that directory.3334### Returns3536- `SkillVersion object`3738  - `type: "skill_version"`3940    Object type.4142    For Skill Versions, this is always `"skill_version"`.4344    default: skill_version4546  - `id: string`4748    Unique identifier for this Skill Version. The id addresses the version in49    paths and pins it in references.5051  - `created_at: string`5253    ISO 8601 timestamp of when the skill was created.5455    format: date-time5657  - `description: string`5859    Description of the skill version.6061    This is extracted from the SKILL.md file in the skill upload.6263  - `name: string`6465    The Skill's immutable kebab-case slug, set at creation from the first66    upload's SKILL.md frontmatter `name` (or its enclosing directory). Every67    later upload must resolve to the same value. Also the top-level directory68    of the Skill's mounted files and the base name of a downloaded archive.6970  - `skill_id: string`7172    Unique identifier for the skill.7374    The format and length of IDs may change over time.7576### Example7778```bash79curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \80    -H 'Content-Type: multipart/form-data' \81    -H 'anthropic-version: 2023-06-01' \82    -H "X-Api-Key: $ANTHROPIC_API_KEY" \83    -F 'files[]=@/path/to/file'84```8586#### Response (200)8788```json89{90  "id": "id",91  "created_at": "2024-10-30T23:58:27.427722Z",92  "description": "description",93  "name": "name",94  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",95  "type": "skill_version"96}97```9899## List Skill Versions100101**GET** `/v1/skills/{skill_id}/versions`102103List Skill Versions104105### Path parameters106107- `skill_id: string`108109  Unique identifier for the skill.110111  The format and length of IDs may change over time.112113### Query parameters114115- `limit: optional number`116117  Number of results to return per page.118119  Ranges from `1` to `1000`. Defaults to `20`.120121  default: 20, minimum: 1, maximum: 1000122123- `page: optional string`124125  Optionally set to the `next_page` token from the previous response.126127### Headers128129- `"anthropic-workspace-id": optional string`130131### Returns132133- `data: array of SkillVersion`134135  List of skills.136137  - `type: "skill_version"`138139    Object type.140141    For Skill Versions, this is always `"skill_version"`.142143    default: skill_version144145  - `id: string`146147    Unique identifier for this Skill Version. The id addresses the version in148    paths and pins it in references.149150  - `created_at: string`151152    ISO 8601 timestamp of when the skill was created.153154    format: date-time155156  - `description: string`157158    Description of the skill version.159160    This is extracted from the SKILL.md file in the skill upload.161162  - `name: string`163164    The Skill's immutable kebab-case slug, set at creation from the first165    upload's SKILL.md frontmatter `name` (or its enclosing directory). Every166    later upload must resolve to the same value. Also the top-level directory167    of the Skill's mounted files and the base name of a downloaded archive.168169  - `skill_id: string`170171    Unique identifier for the skill.172173    The format and length of IDs may change over time.174175- `next_page: string or null`176177  Token for fetching the next page of results.178179  If `null`, there are no more results available. Pass this value to the `page` parameter in the next request to get the next page.180181### Example182183```bash184curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions \185    -H 'anthropic-version: 2023-06-01' \186    -H "X-Api-Key: $ANTHROPIC_API_KEY"187```188189#### Response (200)190191```json192{193  "data": [194    {195      "id": "id",196      "created_at": "2024-10-30T23:58:27.427722Z",197      "description": "description",198      "name": "name",199      "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",200      "type": "skill_version"201    }202  ],203  "next_page": "next_page"204}205```206207## Get Skill Version208209**GET** `/v1/skills/{skill_id}/versions/{version}`210211Get Skill Version212213### Path parameters214215- `skill_id: string`216217  Unique identifier for the skill.218219  The format and length of IDs may change over time.220221- `version: string`222223  Identifies the skill version: a version ID, or the literal `latest` for the skill's most recent version.224225  Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").226227### Headers228229- `"anthropic-workspace-id": optional string`230231### Returns232233- `SkillVersion object`234235  - `type: "skill_version"`236237    Object type.238239    For Skill Versions, this is always `"skill_version"`.240241    default: skill_version242243  - `id: string`244245    Unique identifier for this Skill Version. The id addresses the version in246    paths and pins it in references.247248  - `created_at: string`249250    ISO 8601 timestamp of when the skill was created.251252    format: date-time253254  - `description: string`255256    Description of the skill version.257258    This is extracted from the SKILL.md file in the skill upload.259260  - `name: string`261262    The Skill's immutable kebab-case slug, set at creation from the first263    upload's SKILL.md frontmatter `name` (or its enclosing directory). Every264    later upload must resolve to the same value. Also the top-level directory265    of the Skill's mounted files and the base name of a downloaded archive.266267  - `skill_id: string`268269    Unique identifier for the skill.270271    The format and length of IDs may change over time.272273### Example274275```bash276curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \277    -H 'anthropic-version: 2023-06-01' \278    -H "X-Api-Key: $ANTHROPIC_API_KEY"279```280281#### Response (200)282283```json284{285  "id": "id",286  "created_at": "2024-10-30T23:58:27.427722Z",287  "description": "description",288  "name": "name",289  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",290  "type": "skill_version"291}292```293294## Delete Skill Version295296**DELETE** `/v1/skills/{skill_id}/versions/{version}`297298Delete Skill Version299300### Path parameters301302- `skill_id: string`303304  Unique identifier for the skill.305306  The format and length of IDs may change over time.307308- `version: string`309310  Identifies the skill version by its version ID.311312  Requests carrying the `skills-2025-10-02` beta header address versions by their Unix epoch timestamp instead (e.g., "1759178010641129").313314### Headers315316- `"anthropic-workspace-id": optional string`317318### Returns319320- `DeletedSkillVersion object`321322  - `type: "skill_version_deleted"`323324    Deleted object type.325326    For Skill Versions, this is always `"skill_version_deleted"`.327328    default: skill_version_deleted329330  - `id: string`331332    Unique identifier for this Skill Version. The id addresses the version in333    paths and pins it in references.334335### Example336337```bash338curl https://api.anthropic.com/v1/skills/$SKILL_ID/versions/$VERSION \339    -X DELETE \340    -H 'anthropic-version: 2023-06-01' \341    -H "X-Api-Key: $ANTHROPIC_API_KEY"342```343344#### Response (200)345346```json347{348  "id": "id",349  "type": "skill_version_deleted"350}351```352353## Domain types354355### Deleted Skill Version356357- `DeletedSkillVersion object`358359  - `type: "skill_version_deleted"`360361    Deleted object type.362363    For Skill Versions, this is always `"skill_version_deleted"`.364365    default: skill_version_deleted366367  - `id: string`368369    Unique identifier for this Skill Version. The id addresses the version in370    paths and pins it in references.371372### Skill Version373374- `SkillVersion object`375376  - `type: "skill_version"`377378    Object type.379380    For Skill Versions, this is always `"skill_version"`.381382    default: skill_version383384  - `id: string`385386    Unique identifier for this Skill Version. The id addresses the version in387    paths and pins it in references.388389  - `created_at: string`390391    ISO 8601 timestamp of when the skill was created.392393    format: date-time394395  - `description: string`396397    Description of the skill version.398399    This is extracted from the SKILL.md file in the skill upload.400401  - `name: string`402403    The Skill's immutable kebab-case slug, set at creation from the first404    upload's SKILL.md frontmatter `name` (or its enclosing directory). Every405    later upload must resolve to the same value. Also the top-level directory406    of the Skill's mounted files and the base name of a downloaded archive.407408  - `skill_id: string`409410    Unique identifier for the skill.411412    The format and length of IDs may change over time.413
Files main
Menu

Theme