Create Skill Version

Changed on Oct 8, 2026

post/v1/skills/{skill_id}/versions

Request

Base URL
https://api.anthropic.com
Auth
none declared

Path parameters

skill_idstring required

Unique identifier for the skill.

The format and length of IDs may change over time.

Headers

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

anthropic-workspace-idstring

Optional header to select the Workspace for this request. The value is a Workspace ID (for example, wrkspc_011CZkZaBF1tNoB5wlCeusgy).

Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace.

Request body multipart/form-data

filesstring[] required

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.

Response

Successful Response

created_atstring date-time required

ISO 8601 timestamp of when the skill was created.

descriptionstring required

Description of the skill version.

This is extracted from the SKILL.md file in the skill upload.

idstring required

Unique identifier for this Skill Version. The id addresses the version in paths and pins it in references.

namestring required

The Skill's immutable kebab-case slug, set at creation from the first upload's SKILL.md frontmatter name (or its enclosing directory). Every later upload must resolve to the same value. Also the top-level directory of the Skill's mounted files and the base name of a downloaded archive.

skill_idstring required

Unique identifier for the skill.

The format and length of IDs may change over time.

type'skill_version' required

Object type.

For Skill Versions, this is always "skill_version".

Example response

{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw"
}

Changes

Oct 8, 2026047ff2a727d5 Revision changes
- breaking
  the response's property type changed from no type to object for status
- breaking
  the response's property type changed from no type to object for status
- info
  added the optional property / to the response with the status
- info
  added the optional property / to the response with the status
- info
  removed discriminator from response property for the response status
- info
  removed discriminator from response property for the response status
- info
  removed from the response property oneOf list for the response status
- info
  removed from the response property oneOf list for the response status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
- info
  added the required property / to the response with the status
Sep 4, 20264789294140a2 Revision changes
- info
  added the new optional header request parameter anthropic-workspace-id
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status

Operation history (4 revisions)