Claude Platform Docs

Versions

Create Skill Version
client.beta.skills.versions.create(stringskillID, VersionCreateParamsparams, RequestOptionsoptions?): VersionCreateResponse
POST/v1/skills/{skill_id}/versions
List Skill Versions
client.beta.skills.versions.list(stringskillID, VersionListParamsparams?, RequestOptionsoptions?): PageCursor<VersionListResponse>
GET/v1/skills/{skill_id}/versions
Download Skill Version Content
client.beta.skills.versions.download(stringversion, VersionDownloadParamsparams, RequestOptionsoptions?): Response
GET/v1/skills/{skill_id}/versions/{version}/content
Get Skill Version
client.beta.skills.versions.retrieve(stringversion, VersionRetrieveParamsparams, RequestOptionsoptions?): VersionRetrieveResponse
GET/v1/skills/{skill_id}/versions/{version}
Delete Skill Version
client.beta.skills.versions.delete(stringversion, VersionDeleteParamsparams, RequestOptionsoptions?): VersionDeleteResponse
DELETE/v1/skills/{skill_id}/versions/{version}
Models
VersionCreateResponse { 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 { 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 { 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 { 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