# Update a skill

> Rename a skill or change its description. Owner only.

Source: https://docs.generalinput.com/api/skills/update



<Endpoint method="PATCH" path="/v1/skills/:id" />

<Access scope="skills:manage" />

Note that a publish re-syncs both fields from the `SKILL.md` frontmatter, so edit the frontmatter when the bundle is the source of truth.

## Body [#body]

| Field         | Type   | Required | Notes                  |
| ------------- | ------ | -------- | ---------------------- |
| `name`        | string | yes      | 1 to 255 characters.   |
| `description` | string | yes      | Up to 1024 characters. |

## Response [#response]

The updated skill detail.

## Errors [#errors]

| Status | When                                       |
| ------ | ------------------------------------------ |
| `400`  | Empty name or description.                 |
| `404`  | Not found, or the member is not the owner. |
| `409`  | Modified concurrently. Refetch and retry.  |