API Reference

Copy Markdown

Open in Claude

Open in ChatGPT

Open in Cursor

---

Copy Markdown

View as Markdown

Skills

Create a new skill.

Skill skills().create(SkillCreateParamsparams = SkillCreateParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

POST/skills

List all skills for the current project.

SkillListPage skills().list(SkillListParamsparams = SkillListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

GET/skills

Get a skill by its ID.

Skill skills().retrieve(SkillRetrieveParamsparams = SkillRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

GET/skills/{skill_id}

Update the default version pointer for a skill.

Skill skills().update(SkillUpdateParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

POST/skills/{skill_id}

Delete a skill by its ID.

DeletedSkill skills().delete(SkillDeleteParamsparams = SkillDeleteParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

DELETE/skills/{skill_id}

ModelsExpand Collapse

class DeletedSkill:

String id

boolean deleted

JsonValue; object_ "skill.deleted"constant"skill.deleted"constant

class Skill:

String id

Unique identifier for the skill.

long createdAt

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

String defaultVersion

Default version for the skill.

String description

Description of the skill.

String latestVersion

Latest version for the skill.

String name

Name of the skill.

JsonValue; object_ "skill"constant"skill"constant

The object type, which is skill.

class SkillList:

List<Skill> data

A list of items

String id

Unique identifier for the skill.

long createdAt

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

String defaultVersion

Default version for the skill.

String description

Description of the skill.

String latestVersion

Latest version for the skill.

String name

Name of the skill.

JsonValue; object_ "skill"constant"skill"constant

The object type, which is skill.

Optional<String> firstId

The ID of the first item in the list.

boolean hasMore

Whether there are more items available.

Optional<String> lastId

The ID of the last item in the list.

JsonValue; object_ "list"constant"list"constant

The type of object returned, must be list.

SkillsContent

Download a skill zip bundle by its ID.

HttpResponse skills().content().retrieve(ContentRetrieveParamsparams = ContentRetrieveParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

GET/skills/{skill_id}/content

SkillsVersions

Create a new immutable skill version.

SkillVersion skills().versions().create(VersionCreateParamsparams = VersionCreateParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

POST/skills/{skill_id}/versions

List skill versions for a skill.

VersionListPage skills().versions().list(VersionListParamsparams = VersionListParams.none(), RequestOptionsrequestOptions = RequestOptions.none())

GET/skills/{skill_id}/versions

Get a specific skill version.

SkillVersion skills().versions().retrieve(VersionRetrieveParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

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

Delete a skill version.

DeletedSkillVersion skills().versions().delete(VersionDeleteParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

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

ModelsExpand Collapse

class DeletedSkillVersion:

String id

boolean deleted

JsonValue; object_ "skill.version.deleted"constant"skill.version.deleted"constant

String version

The deleted skill version.

class SkillVersion:

String id

Unique identifier for the skill version.

long createdAt

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

String description

Description of the skill version.

String name

Name of the skill version.

JsonValue; object_ "skill.version"constant"skill.version"constant

The object type, which is skill.version.

String skillId

Identifier of the skill for this version.

String version

Version number for this skill.

class SkillVersionList:

List<SkillVersion> data

A list of items

String id

Unique identifier for the skill version.

long createdAt

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

String description

Description of the skill version.

String name

Name of the skill version.

JsonValue; object_ "skill.version"constant"skill.version"constant

The object type, which is skill.version.

String skillId

Identifier of the skill for this version.

String version

Version number for this skill.

Optional<String> firstId

The ID of the first item in the list.

boolean hasMore

Whether there are more items available.

Optional<String> lastId

The ID of the last item in the list.

JsonValue; object_ "list"constant"list"constant

The type of object returned, must be list.

SkillsVersionsContent

Download a skill version zip bundle.

HttpResponse skills().versions().content().retrieve(ContentRetrieveParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

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