API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Skills

Create a new skill.

client.skills.create(SkillCreateParams { files } body?, RequestOptionsoptions?): Skill { id, created_at, default_version, 4 more }

POST/skills

Delete a skill by its ID.

client.skills.delete(stringskillID, RequestOptionsoptions?): DeletedSkill { id, deleted, object }

DELETE/skills/{skill_id}

List all skills for the current project.

client.skills.list(SkillListParams { after, limit, order } query?, RequestOptionsoptions?): CursorPage<Skill { id, created_at, default_version, 4 more } >

GET/skills

Get a skill by its ID.

client.skills.retrieve(stringskillID, RequestOptionsoptions?): Skill { id, created_at, default_version, 4 more }

GET/skills/{skill_id}

Update the default version pointer for a skill.

client.skills.update(stringskillID, SkillUpdateParams { default_version } body, RequestOptionsoptions?): Skill { id, created_at, default_version, 4 more }

POST/skills/{skill_id}

ModelsExpand Collapse

DeletedSkill { id, deleted, object }

Skill { id, created_at, default_version, 4 more }

SkillList { data, first_id, has_more, 2 more }

SkillsContent

Download a skill zip bundle by its ID.

client.skills.content.retrieve(stringskillID, RequestOptionsoptions?): Response

GET/skills/{skill_id}/content

SkillsVersions

Create a new immutable skill version.

client.skills.versions.create(stringskillID, VersionCreateParams { _default, files } body?, RequestOptionsoptions?): SkillVersion { id, created_at, description, 4 more }

POST/skills/{skill_id}/versions

Delete a skill version.

client.skills.versions.delete(stringversion, VersionDeleteParams { skill_id } params, RequestOptionsoptions?): DeletedSkillVersion { id, deleted, object, version }

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

List skill versions for a skill.

client.skills.versions.list(stringskillID, VersionListParams { after, limit, order } query?, RequestOptionsoptions?): CursorPage<SkillVersion { id, created_at, description, 4 more } >

GET/skills/{skill_id}/versions

Get a specific skill version.

client.skills.versions.retrieve(stringversion, VersionRetrieveParams { skill_id } params, RequestOptionsoptions?): SkillVersion { id, created_at, description, 4 more }

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

ModelsExpand Collapse

DeletedSkillVersion { id, deleted, object, version }

SkillVersion { id, created_at, description, 4 more }

SkillVersionList { data, first_id, has_more, 2 more }

SkillsVersionsContent

Download a skill version zip bundle.

client.skills.versions.content.retrieve(stringversion, ContentRetrieveParams { skill_id } params, RequestOptionsoptions?): Response

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