Versions

Create Skill Version

beta.skills.versions.create(skill_id, **kwargs) -> VersionCreateResponse { id, created_at, description, 5 more }

POST/v1/skills/{skill_id}/versions

List Skill Versions

beta.skills.versions.list(skill_id, **kwargs) -> PageCursor<VersionListResponse { id, created_at, description, 5 more } >

GET/v1/skills/{skill_id}/versions

Get Skill Version

beta.skills.versions.retrieve(version, **kwargs) -> VersionRetrieveResponse { id, created_at, description, 5 more }

GET/v1/skills/{skill_id}/versions/{version}

Delete Skill Version

beta.skills.versions.delete(version, **kwargs) -> VersionDeleteResponse { id, type }

DELETE/v1/skills/{skill_id}/versions/{version}

ModelsExpand Collapse

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

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

version: String

Version identifier for the skill.

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

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

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

version: String

Version identifier for the skill.

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

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

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

version: String

Version identifier for the skill.

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

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

Versions

Create Skill Version

beta.skills.versions.create(skill_id, **kwargs) -> VersionCreateResponse { id, created_at, description, 5 more }

POST/v1/skills/{skill_id}/versions

List Skill Versions

beta.skills.versions.list(skill_id, **kwargs) -> PageCursor<VersionListResponse { id, created_at, description, 5 more } >

GET/v1/skills/{skill_id}/versions

Get Skill Version

beta.skills.versions.retrieve(version, **kwargs) -> VersionRetrieveResponse { id, created_at, description, 5 more }

GET/v1/skills/{skill_id}/versions/{version}

Delete Skill Version

beta.skills.versions.delete(version, **kwargs) -> VersionDeleteResponse { id, type }

DELETE/v1/skills/{skill_id}/versions/{version}

ModelsExpand Collapse

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

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

version: String

Version identifier for the skill.

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

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

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

version: String

Version identifier for the skill.

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

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

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

version: String

Version identifier for the skill.

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

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