Skip to main content
PUT
Update Skill

Authorizations

Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

project_reference
string
required
skill_id
string
required

Skill identifier

Query Parameters

source_target_kind
string
target_branch_id
string<uuid> | null

Body

application/json
description
string
required

Max 1024 characters. Non-empty. Describes what the skill does and when to use it.

Required string length: 1 - 1024
name
string

Canonical skill name, also used as the skill directory name. Max 64 characters. Lowercase letters, numbers, and hyphens only. Must not start or end with a hyphen, and must not contain consecutive hyphens.

Required string length: 1 - 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
allowed_tools
string[]
Minimum string length: 1
instructions
string

Full markdown body of SKILL.md — everything below the frontmatter.

source
string
Minimum string length: 1

Response

Updated project skill document

id
string
required
name
string
required
description
string
required
source_path
string
required
edit_mode
enum<string>
required
Available options:
structured,
source_only
instructions
string
required

Full markdown body of SKILL.md, below the frontmatter

sections
object
required

Read-only, best-effort projection of the body split on ## headings. Empty when the body is not section-addressable, and never authoritative — instructions is the body. Not writable.

source
string
required
source_only_reasons
string[]
required
allowed_tools
string[]
owner_agent_id
string
short_name
string