v1

latestOpenAPI 3.0.02026-07-26492143.5 KB

Skills

Update skill

Replace a skill's files with a new upload. Reparses SKILL.md to update the skill's name, description, and metadata, and creates a new version. Maximum upload size is 10 MB.

patch/skills/{skill_id}

Path parameters

skill_idstring required

ID of the skill to update.

Response

Skill updated. The returned version_id and major_version reflect the new version that was created.

Example response

{
  "skill": {
    "id": "skill_x7y8z9",
    "name": "Lead enrichment",
    "description": "Enriches inbound leads with firmographics and intent signals.",
    "team_id": "team_4f8c92ab",
    "created_at": "2026-05-15T14:32:00Z",
    "updated_at": "2026-05-19T11:42:00Z",
    "usage_count": 42,
    "view_count": 117,
    "last_used_at": "2026-05-18T22:01:00Z",
    "version_id": "sv_b9c8d7e6",
    "major_version": 4,
    "version_created_at": "2026-05-19T11:42:00Z"
  }
}