API Reference

Skills

Copy Markdown

Open in ChatGPT

---

Copy Markdown

View as Markdown

Versions

Create a new immutable skill version.

skills.versions.create(strskill_id, VersionCreateParams**kwargs) -> SkillVersion

POST/skills/{skill_id}/versions

List skill versions for a skill.

skills.versions.list(strskill_id, VersionListParams**kwargs) -> SyncCursorPage[SkillVersion]

GET/skills/{skill_id}/versions

Get a specific skill version.

skills.versions.retrieve(strversion, VersionRetrieveParams**kwargs) -> SkillVersion

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

Delete a skill version.

skills.versions.delete(strversion, VersionDeleteParams**kwargs) -> DeletedSkillVersion

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

ModelsExpand Collapse

class DeletedSkillVersion: …

id: str

deleted: bool

object: Literal["skill.version.deleted"]

version: str

The deleted skill version.

class SkillVersion: …

id: str

Unique identifier for the skill version.

created_at: int

Unix timestamp (seconds) for when the version was created.

description: str

Description of the skill version.

name: str

Name of the skill version.

object: Literal["skill.version"]

The object type, which is skill.version.

skill_id: str

Identifier of the skill for this version.

version: str

Version number for this skill.

class SkillVersionList: …

data: List[SkillVersion]

A list of items

id: str

Unique identifier for the skill version.

created_at: int

Unix timestamp (seconds) for when the version was created.

description: str

Description of the skill version.

name: str

Name of the skill version.

object: Literal["skill.version"]

The object type, which is skill.version.

skill_id: str

Identifier of the skill for this version.

version: str

Version number for this skill.

first_id: Optional[str]

The ID of the first item in the list.

has_more: bool

Whether there are more items available.

last_id: Optional[str]

The ID of the last item in the list.

object: Literal["list"]

The type of object returned, must be list.

VersionsContent

Download a skill version zip bundle.

skills.versions.content.retrieve(strversion, ContentRetrieveParams**kwargs) -> BinaryResponseContent

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