---
title: "Update an organization skill"
method: PATCH
path: "/api/experimental/organizations/{organization}/skills/{skillName}"
tags: ["Organizations"]
---

# Update an organization skill

`PATCH /api/experimental/organizations/{organization}/skills/{skillName}`

## Request

- Base URL: `/` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/experimental/organizations/{organization}/skills/{skillName}`
- Auth: API key in header `Coder-Session-Token`

## Path parameters

- `organization` string, required
- `skillName` string, required

## Request body

- CodersdkUpdateSkillRequest
  - `action` boolean: Action is only accepted for project skills.
  - `content` string: Content must be SKILL.md-format Markdown with YAML frontmatter. The frontmatter must include name, may include description, and must be followed by a non-empty body.
  - `enabled` boolean
  - `model_invocable` boolean

## Response `200`

OK

- CodersdkSkill
  - `action` boolean: Action reports whether a project skill is offered as a one-click action above project composers. It is always false for personal and organization skills.
  - `content` string
  - `created_at` string, date-time
  - `description` string
  - `enabled` boolean
  - `id` string, uuid
  - `model_invocable` boolean: ModelInvocable reports whether agents can discover and load the skill on their own. Users can still invoke a skill explicitly when it is false.
  - `name` string
  - `updated_at` string, date-time

## Changes

- **2026-10-13** `3b42152d944e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/coder/apis/coder-api/changes/api/experimental/organizations/:organization/skills/:skillName/patch.md)

---

[API](https://skmtc.dev/coder/apis/coder-api.md) - [All operations](https://skmtc.dev/coder/apis/coder-api/llms.txt) - [OpenAPI document](https://skmtc.dev/coder/apis/coder-api/revisions/4669d93796ab?raw)