Edit Skill Metadata or SKILL.md Body (Single-File Skills)
PATCH
/skills-service/api/v2/skills/{skill_id}
SKILL.md file of a single-file skill — bundle skills are not editable via this endpoint. Use this when you want to tweak the skill's description or instructions without changing reference files or doing a full bundle re-upload.skill_id: The Ejento id of the skill to update.description (optional): New description. Empty string clears it.content (optional): New SKILL.md body text (without frontmatter). ≤ 9 MB.category is not accepted here — it is managed by the platform and not editable through this endpoint.200 OK with the refreshed skill record, the file path (SKILL.md), and the new size.404 skill_not_found — no skill with this name exists.409 skill_type_mismatch — target is a bundle; use PUT instead.403 system_curated_immutable — skill is system-curated.403 permission_denied — caller lacks permission to manage skills.422 — empty body, oversize content, or unknown fields.Request
Path Params
Header Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --globoff --request PATCH 'https:///skills-service/api/v2/skills/' \
--header 'Ocp-Apim-Subscription-Key: ' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{
"content": "# My Skill\n\nThis is the new SKILL.md body.",
"description": "Updated description for my skill."
}'Response Response Example
200 - Example 1
{
"data": {
"file_path": "SKILL.md",
"size": 512,
"skill": {
"category": "Engineering",
"created_by": "[email protected]",
"created_on": "2026-05-21T12:00:00Z",
"description": "My skill description.",
"id": 42,
"is_default": false,
"is_draft": false,
"is_enabled": true,
"modified_by": "[email protected]",
"modified_on": "2026-05-21T12:00:00Z",
"name": "my-skill",
"org_id": 7,
"type": "bundle"
}
},
"message": "SKILL.md updated",
"success": true
}