Sign in

v49

latestOpenAPI 3.1.0raw.githubusercontent.com2026-07-261319281.7 MB

Create Skill Version

post/v1/skills/{skill_id}/versions?beta=true

Path parameters

skill_idstring required

Unique identifier for the skill.

The format and length of IDs may change over time.

Unique identifier for the skill.

The format and length of IDs may change over time.

Headers

anthropic-betastring

Optional header to specify the beta version(s) you want to use.

To use multiple betas, use a comma separated list like beta1,beta2 or specify the header multiple times for each beta.

Optional header to specify the beta version(s) you want to use.

To use multiple betas, use a comma separated list like beta1,beta2 or specify the header multiple times for each beta.

anthropic-versionstring

The version of the Claude API you want to use.

Read more about versioning and our version history here.

The version of the Claude API you want to use.

Read more about versioning and our version history here.

Response

Successful Response

created_atstring required

ISO 8601 timestamp of when the skill version was created.

descriptionstring required

Description of the skill version.

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

directorystring required

Directory name of the skill version.

This is the top-level directory name that was extracted from the uploaded files.

idstring required

Unique identifier for the skill version.

The format and length of IDs may change over time.

namestring required

Human-readable name of the skill version.

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

skill_idstring required

Identifier for the skill that this version belongs to.

typestring required

Object type.

For Skill Versions, this is always "skill_version".

versionstring required

Version identifier for the skill.

Each version is identified by a Unix epoch timestamp (e.g., "1759178010641129").

Example response

{
  "created_at": "2024-10-30T23:58:27.427722Z",
  "description": "A custom skill for doing something useful",
  "directory": "my-skill",
  "id": "skillver_01JAbcdefghijklmnopqrstuvw",
  "name": "my-skill",
  "skill_id": "skill_01JAbcdefghijklmnopqrstuvw",
  "version": "1759178010641129"
}