skills

Set the default version pointer for a skill.

post/api/v1/skills/{skill_id}

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/v1/skills/{skill_id}
  • Auth: HTTP bearer

Path parameters

skill_idstring required

Skill id

Request body

default_versionstring required

The skill version number to set as default.

Response

Skill

allowed_toolsstring[] nullable

Hadrian Extension: SKILL.md frontmatter — tools the skill may use.

argument_hintstring nullable

Hadrian Extension: SKILL.md frontmatter — argument hint for autocomplete.

created_atinteger required

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

default_versionstring required

Default version number.

descriptionstring required
disable_model_invocationboolean nullable

Hadrian Extension: SKILL.md frontmatter flag — block model auto-invocation.

frontmatter_extraobject nullable

Hadrian Extension: unknown/forward-compat frontmatter keys, preserved verbatim.

idstring required

Unique identifier (skill_<uuid>).

latest_versionstring required

Latest version number.

namestring required
objectstring required

Object type, always skill.

owner_idstring required

Hadrian Extension: owner id.

owner_typestring required

Hadrian Extension: owner kind (organization/team/project/user).

source_refstring nullable

Hadrian Extension: git ref when imported.

source_urlstring nullable

Hadrian Extension: origin URL when imported.

total_bytesinteger required

Hadrian Extension: default version's total file size in bytes.

user_invocableboolean nullable

Hadrian Extension: SKILL.md frontmatter flag — hide from the user / menu.

Changes

No recorded changes to this operation across all 1 revision of this API.