---
title: "Update custom skill"
method: PUT
path: "/skills/{slug}"
tags: ["Skills"]
---

# Update custom skill

`PUT /skills/{slug}`

Update an org-scoped custom skill by slug. Only provided fields are updated. Version is auto-incremented.

## Path parameters

- `slug` string, required

## Request body

- object
  - `name` string
  - `slug` string — New slug (renames the skill)
  - `summary` string, nullable
  - `content` string
  - `tags` string[]
  - `metadata` object

## Response `200`

Skill updated

- object
  - `slug` string
  - `name` string
  - `summary` string, nullable
  - `content` string
  - `tags` string[]
  - `metadata` object
  - `version` integer
  - `updated_at` string, date-time

## Other responses

- `400` — Invalid input
- `401` — Authentication required
- `403` — Insufficient permissions
- `404` — Skill not found in this org
- `409` — Slug conflict

---

[API](https://skmtc.net/casemark/apis/case-dev-api.md) · [All operations](https://skmtc.net/casemark/apis/case-dev-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/casemark/case-dev-api/revisions/5b7e64e6d6f9/schema)