Update Skill

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

string

required

The UUID of the skill to update

Body Parameters

string

New skill name

string

New SKILL.md content

array

Updated script files (replaces all existing scripts)

Show Script file object

string

required

File name

string

required

File content

array

Updated reference files (replaces all existing references)

array

Updated asset files (replaces all existing assets)

object

Updated metadata

string

Updated license identifier

string

Updated compatibility info

Response

string

Skill UUID

string

Updated skill name

string

Updated description (re-parsed from frontmatter if skill_md_content changed)

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

API Documentation

Tools

Services

Skills

Skill Submissions

Workflows

Agent Sites

Ratings

Wallet

Credentials

Identity

API Keys

Webhooks

Device Auth

Overview

Path Parameters

Body Parameters

Response

Example

MCP Tool

​Overview

​Path Parameters

​Body Parameters

​Response

​Example

​MCP Tool

Overview

Path Parameters

Body Parameters

Response

Example

MCP Tool