Claude Platform Docs

Versions

Create Skill Version
POST/v1/skills/{skill_id}/versions
List Skill Versions
GET/v1/skills/{skill_id}/versions
Download Skill Version Content
GET/v1/skills/{skill_id}/versions/{version}/content
Get Skill Version
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
DELETE/v1/skills/{skill_id}/versions/{version}
Models
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".

defaultskill_version
version: string

Version identifier for the skill.

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

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".

defaultskill_version
version: string

Version identifier for the skill.

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

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".

defaultskill_version
version: string

Version identifier for the skill.

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

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".

defaultskill_version_deleted