API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Skills

Create Skill

skills.create(**kwargs) -> Skill { id, created_at, default_version, 4 more }

POST/skills

List Skills

skills.list(**kwargs) -> CursorPage<Skill { id, created_at, default_version, 4 more } >

GET/skills

Get Skill

skills.retrieve(skill_id) -> Skill { id, created_at, default_version, 4 more }

GET/skills/{skill_id}

Update Skill Default Version

skills.update(skill_id, **kwargs) -> Skill { id, created_at, default_version, 4 more }

POST/skills/{skill_id}

Delete Skill

skills.delete(skill_id) -> DeletedSkill { id, deleted, object }

DELETE/skills/{skill_id}

ModelsExpand Collapse

class DeletedSkill { id, deleted, object }

id: String

deleted: bool

object: :"skill.deleted"

class Skill { id, created_at, default_version, 4 more }

id: String

Unique identifier for the skill.

created_at: Integer

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

default_version: String

Default version for the skill.

description: String

Description of the skill.

latest_version: String

Latest version for the skill.

name: String

Name of the skill.

object: :skill

The object type, which is skill.

class SkillList { data, first_id, has_more, 2 more }

data: Array[Skill { id, created_at, default_version, 4 more } ]

A list of items

id: String

Unique identifier for the skill.

created_at: Integer

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

default_version: String

Default version for the skill.

description: String

Description of the skill.

latest_version: String

Latest version for the skill.

name: String

Name of the skill.

object: :skill

The object type, which is skill.

first_id: String

The ID of the first item in the list.

has_more: bool

Whether there are more items available.

last_id: String

The ID of the last item in the list.

object: :list

The type of object returned, must be list.

SkillsContent

Get Skill Content

skills.content.retrieve(skill_id) -> StringIO

GET/skills/{skill_id}/content

SkillsVersions

Create Skill Version

skills.versions.create(skill_id, **kwargs) -> SkillVersion { id, created_at, description, 4 more }

POST/skills/{skill_id}/versions

List Skill Versions

skills.versions.list(skill_id, **kwargs) -> CursorPage<SkillVersion { id, created_at, description, 4 more } >

GET/skills/{skill_id}/versions

Get Skill Version

skills.versions.retrieve(version, **kwargs) -> SkillVersion { id, created_at, description, 4 more }

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

Delete Skill Version

skills.versions.delete(version, **kwargs) -> DeletedSkillVersion { id, deleted, object, version }

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

ModelsExpand Collapse

class DeletedSkillVersion { id, deleted, object, version }

id: String

deleted: bool

object: :"skill.version.deleted"

version: String

The deleted skill version.

class SkillVersion { id, created_at, description, 4 more }

id: String

Unique identifier for the skill version.

created_at: Integer

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

description: String

Description of the skill version.

name: String

Name of the skill version.

object: :"skill.version"

The object type, which is skill.version.

skill_id: String

Identifier of the skill for this version.

version: String

Version number for this skill.

class SkillVersionList { data, first_id, has_more, 2 more }

data: Array[SkillVersion { id, created_at, description, 4 more } ]

A list of items

id: String

Unique identifier for the skill version.

created_at: Integer

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

description: String

Description of the skill version.

name: String

Name of the skill version.

object: :"skill.version"

The object type, which is skill.version.

skill_id: String

Identifier of the skill for this version.

version: String

Version number for this skill.

first_id: String

The ID of the first item in the list.

has_more: bool

Whether there are more items available.

last_id: String

The ID of the last item in the list.

object: :list

The type of object returned, must be list.

SkillsVersionsContent

Get Skill Version Content

skills.versions.content.retrieve(version, **kwargs) -> StringIO

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