Skip to main content
POST
Copy a skill

Authorizations

Authorization
string
header
required

An API key, sent as Authorization: Bearer stfy_live_…. See Authentication for how to get one and which scopes it needs.

Path Parameters

key
string
required

The skill's key, from GET /v1/skills

Maximum string length: 64

Body

application/json
name
string

The copy's name; the source's when left out

Required string length: 1 - 255

Response

201 - application/json

Successful Response

description
string
required

What an agent reads every turn to decide when to use it

enabled
boolean
required

Whether agents in this workspace load it

key
string
required

Fixed when the skill is made: the name agents call it by

name
string
required
source
enum<string>
required

statisfy (shipped by Statisfy: read-only, but each workspace can turn it off) or workspace (this workspace's own)

Available options:
statisfy,
workspace
status
enum<string>
required

The skill's own state. A Statisfy skill turned off by this workspace stays enabled here: see enabled

Available options:
enabled,
disabled,
archived
used_by
SkillAgent · object[] | null
required

Every agent it is set on (archived agents left out). Changing a skill in use needs 'skills:publish'. Null when a change saved but its agents could not be read: read the skill again

version
integer | null
required

The live version, what a change or POST /v1/skills/{key}/live sends back as expected_version. Null when storage could not be read