Update Skill - Danube

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..."
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    skill = client.skills.update(
        skill_id="skill_abc123",
        name="pdf-processing-v2",
    )
    print(f"Updated: {skill.name}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const skill = await client.skills.update('skill_abc123', {
  name: 'pdf-processing-v2',
});
console.log(`Updated: ${skill.name}`);

{
  "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"
}

PATCH

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..."
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    skill = client.skills.update(
        skill_id="skill_abc123",
        name="pdf-processing-v2",
    )
    print(f"Updated: {skill.name}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const skill = await client.skills.update('skill_abc123', {
  name: 'pdf-processing-v2',
});
console.log(`Updated: ${skill.name}`);

{
  "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)

Show Script file object

name

string

required

File name

content

string

required

File content

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

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..."
  }'

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    skill = client.skills.update(
        skill_id="skill_abc123",
        name="pdf-processing-v2",
    )
    print(f"Updated: {skill.name}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const skill = await client.skills.update('skill_abc123', {
  name: 'pdf-processing-v2',
});
console.log(`Updated: ${skill.name}`);

{
  "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"
})

Create Skill Delete Skill

​Overview

​Path Parameters

​Body Parameters

​Response

​Example

​MCP Tool

Overview

Path Parameters

Body Parameters

Response

Example

MCP Tool