🌍 Global Mirror — Visit original CN site →
Skip to content
Primary navigation
API Dashboard
API Reference

Skills

Create a new skill.
skills.create(SkillCreateParams**kwargs) -> Skill
POST/skills
List all skills for the current project.
skills.list(SkillListParams**kwargs) -> SyncCursorPage[Skill]
GET/skills
Get a skill by its ID.
skills.retrieve(strskill_id) -> Skill
GET/skills/{skill_id}
Update the default version pointer for a skill.
skills.update(strskill_id, SkillUpdateParams**kwargs) -> Skill
POST/skills/{skill_id}
Delete a skill by its ID.
skills.delete(strskill_id) -> DeletedSkill
DELETE/skills/{skill_id}
ModelsExpand Collapse
class DeletedSkill: …
id: str
deleted: bool
object: Literal["skill.deleted"]
class Skill: …
id: str

Unique identifier for the skill.

created_at: int

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

default_version: str

Default version for the skill.

description: str

Description of the skill.

latest_version: str

Latest version for the skill.

name: str

Name of the skill.

object: Literal["skill"]

The object type, which is skill.

class SkillList: …
data: List[Skill]

A list of items

id: str

Unique identifier for the skill.

created_at: int

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

default_version: str

Default version for the skill.

description: str

Description of the skill.

latest_version: str

Latest version for the skill.

name: str

Name of the skill.

object: Literal["skill"]

The object type, which is 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.

SkillsContent

Download a skill zip bundle by its ID.
skills.content.retrieve(strskill_id) -> BinaryResponseContent
GET/skills/{skill_id}/content

SkillsVersions

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.

SkillsVersionsContent

Download a skill version zip bundle.
skills.versions.content.retrieve(strversion, ContentRetrieveParams**kwargs) -> BinaryResponseContent
GET/skills/{skill_id}/versions/{version}/content