Skip to content
API Reference

Skills

Create Skill
client.skills.create(SkillCreateParams { files } body?, RequestOptionsoptions?): Skill { id, created_at, default_version, 4 more }
POST/skills
List Skills
client.skills.list(SkillListParams { after, limit, order } query?, RequestOptionsoptions?): CursorPage<Skill { id, created_at, default_version, 4 more } >
GET/skills
Get Skill
client.skills.retrieve(stringskillID, RequestOptionsoptions?): Skill { id, created_at, default_version, 4 more }
GET/skills/{skill_id}
Update Skill Default Version
client.skills.update(stringskillID, SkillUpdateParams { default_version } body, RequestOptionsoptions?): Skill { id, created_at, default_version, 4 more }
POST/skills/{skill_id}
Delete Skill
client.skills.delete(stringskillID, RequestOptionsoptions?): DeletedSkill { id, deleted, object }
DELETE/skills/{skill_id}
ModelsExpand Collapse
DeletedSkill { id, deleted, object }
id: string
deleted: boolean
object: "skill.deleted"
Skill { id, created_at, default_version, 4 more }
id: string

Unique identifier for the skill.

created_at: number

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.

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: number

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 | null

The ID of the first item in the list.

has_more: boolean

Whether there are more items available.

last_id: string | null

The ID of the last item in the list.

object: "list"

The type of object returned, must be list.

SkillsContent

Get Skill Content
client.skills.content.retrieve(stringskillID, RequestOptionsoptions?): Response
GET/skills/{skill_id}/content

SkillsVersions

Create Skill Version
client.skills.versions.create(stringskillID, VersionCreateParams { _default, files } body?, RequestOptionsoptions?): SkillVersion { id, created_at, description, 4 more }
POST/skills/{skill_id}/versions
List Skill Versions
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 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}
Delete Skill Version
client.skills.versions.delete(stringversion, VersionDeleteParams { skill_id } params, RequestOptionsoptions?): DeletedSkillVersion { id, deleted, object, version }
DELETE/skills/{skill_id}/versions/{version}
ModelsExpand Collapse
DeletedSkillVersion { id, deleted, object, version }
id: string
deleted: boolean
object: "skill.version.deleted"
version: string

The deleted skill version.

SkillVersion { id, created_at, description, 4 more }
id: string

Unique identifier for the skill version.

created_at: number

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.

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: number

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 | null

The ID of the first item in the list.

has_more: boolean

Whether there are more items available.

last_id: string | null

The ID of the last item in the list.

object: "list"

The type of object returned, must be list.

SkillsVersionsContent

Get Skill Version Content
client.skills.versions.content.retrieve(stringversion, ContentRetrieveParams { skill_id } params, RequestOptionsoptions?): Response
GET/skills/{skill_id}/versions/{version}/content