Skip to main content
PATCH
/
v1
/
skills
/
{skill_id}
curl -X PATCH "https://api.danubeai.com/v1/skills/skill_abc123" \
  -H "danube-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pdf-processing-v2",
    "skill_md_content": "---\ndescription: Enhanced PDF processing\n---\n\n# PDF Processing v2\n..."
  }'

{
  "id": "skill_abc123",
  "name": "pdf-processing-v2",
  "description": "Enhanced PDF processing",
  "skill_md": "---\ndescription: Enhanced PDF processing\n---\n...",
  "scripts": [],
  "references": [],
  "assets": [],
  "visibility": "private",
  "updated_at": "2026-02-24T14:00:00Z"
}

​
Overview

Updates a skill’s name, content, scripts, references, or assets. Only the skill owner can update it. Auth: Accepts either JWT or API key (danube-api-key header).

​
Path Parameters

​
skill_id
string
required
The UUID of the skill to update

​
Body Parameters

​
name
string
New skill name
​
skill_md_content
string
New SKILL.md content
​
scripts
array
Updated script files (replaces all existing scripts)
​
reference_files
array
Updated reference files (replaces all existing references)
​
assets
array
Updated asset files (replaces all existing assets)
​
metadata
object
Updated metadata
​
license
string
Updated license identifier
​
compatibility
string
Updated compatibility info

​
Response

​
id
string
Skill UUID
​
name
string
Updated skill name
​
description
string
Updated description (re-parsed from frontmatter if skill_md_content changed)
​
skill_md
string
Updated SKILL.md content

​
Example

curl -X PATCH "https://api.danubeai.com/v1/skills/skill_abc123" \
  -H "danube-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "pdf-processing-v2",
    "skill_md_content": "---\ndescription: Enhanced PDF processing\n---\n\n# PDF Processing v2\n..."
  }'

{
  "id": "skill_abc123",
  "name": "pdf-processing-v2",
  "description": "Enhanced PDF processing",
  "skill_md": "---\ndescription: Enhanced PDF processing\n---\n...",
  "scripts": [],
  "references": [],
  "assets": [],
  "visibility": "private",
  "updated_at": "2026-02-24T14:00:00Z"
}

​
MCP Tool

This endpoint is also available as the update_skill MCP tool: 
result = await mcp.call_tool("update_skill", {
    "skill_id": "skill_abc123",
    "name": "pdf-processing-v2"
})