Skip to main content
PATCH
Turn a skill on or off for your org's agents, built-in or custom. Repeating the same switch changes nothing. Needs a key with the `skills:write` scope.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

name
string
required

Body

application/json
enabled
boolean
required

false turns the skill off for your org's agents, true back on.

Response

The skill as your org now sees it, with its ETag.

object
string
required
Allowed value: "skill"
name
string
required

The skill's name, e.g. create-realistic-images.

description
string
required

When to use the skill (its SKILL.md description).

version
string
required

SHA-256 of the skill's files in path order; changes with any file.

Pattern: ^[0-9a-f]{64}$
source
enum<string>
required

built-in: one of Spiral's reviewed skills; custom: your org's own.

Available options:
built-in,
custom
enabled
boolean
required

Whether your agents should load it: on unless your org turned it off (PATCH /v1/skills/{name}).

category
enum<string> | null
required

SKILL.md's category, one of the tool categories; null when it names none.

Available options:
llm,
image,
video,
3d,
audio,
web,
data,
social-media,
e-commerce,
finance,
lead-gen,
public-records,
listings,
maps-reviews,
seo,
news-media,
developer,
sports,
industry-data,
health
title
string | null
required

The skill's title: SKILL.md's first # heading (at most 120 characters); null when it has none.

capabilities
object[]
required

The tools its instructions call, each written as a code span provider/model, in order of first appearance.

files
object[]
required

Every file of the skill, in path order.