Skip to main content
PUT
/
api
/
v1
/
skills
/
{id}
Update skill
curl --request PUT \
  --url http://localhost:3001/api/v1/skills/{id} \
  --header 'Content-Type: application/json' \
  --cookie nut-session= \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "content": "<string>",
  "license": "<string>",
  "compatibility": "<string>",
  "allowedTools": "<string>",
  "metadata": {}
}
'
{
  "success": true,
  "document": {
    "id": "<string>",
    "name": "<string>",
    "description": "<string>",
    "license": "<string>",
    "compatibility": "<string>",
    "allowedTools": "<string>",
    "metadata": {},
    "content": "<string>"
  }
}

Authorizations

nut-session
string
cookie
required

Session cookie authentication

Path Parameters

id
string
required

Current skill identifier

Body

application/json
name
string

New skill name (triggers directory rename if changed)

description
string

Updated description

content
string

Updated skill instructions (Markdown body)

license
string

Updated license identifier

compatibility
string

Updated compatibility requirements

allowedTools
string

Updated space-delimited tool list

metadata
object

Metadata fields to merge with existing metadata

Response

Skill updated

success
boolean
document
object

A skill document following the Agent Skills specification. Stored as .nut/skills/<id>/SKILL.md with YAML frontmatter.