skills

Create a new skill (and its first version).

Changed on
post/api/v1/skills

Request

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

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.

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.

namestring nullable

Hadrian Extension: skill name slug; sniffed from SKILL.md frontmatter when omitted.

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

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