Sign in
skills

Create a new immutable version of a skill.

post/api/v1/skills/{skill_id}/versions

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}/versions
  • Auth: HTTP bearer

Path parameters

skill_idstring required

Skill id

Request body

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.

defaultboolean

Whether to set this version as the default.

descriptionstring nullable

Hadrian Extension: description; sniffed from SKILL.md frontmatter when omitted.

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.

source_refstring nullable

Hadrian Extension: git ref when imported.

source_urlstring nullable

Hadrian Extension: origin URL when imported.

user_invocableboolean nullable

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

Response

Version created

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 version was created.

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 (skillver_<uuid>).

namestring required
objectstring required

Object type, always skill.version.

skill_idstring required

Identifier of the parent skill (skill_<uuid>).

source_refstring nullable

Hadrian Extension: git ref when imported.

source_urlstring nullable

Hadrian Extension: origin URL when imported.

total_bytesinteger required

Hadrian Extension: total file size in bytes.

user_invocableboolean nullable

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

versionstring required

Version number for this skill.

Changes

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