---
title: "Changes to Update a skill"
method: PATCH
path: "/v2/skills/{skill_id}"
---

# Changes to Update a skill

`PATCH /v2/skills/{skill_id}`

> Every recorded change to this operation, newest first.
> 554 revisions in range; 71 not diffed.

## Timeline

Changed in 23 of 554 revisions.

- **2026-10-23** `0b4e519a544f`: 1 info
- **2026-10-23** `732aed62833a`: 1 info
- **2026-10-22** `4f826b2c3a0e`: 1 info
- **2026-10-22** `8f0dc569f247`: 1 info
- **2026-10-21** `08b800d640e6`: 1 info
- **2026-10-21** `3ce0047cb0a0`: 1 info
- **2026-10-20** `509fb3426748`: 1 info
- **2026-10-20** `fa3268994006`: 1 info
- **2026-10-20** `5e1d272a28f3`: 1 info
- **2026-10-20** `57adccdd4749`: 1 info
- **2026-10-19** `403429a2fc35`: 1 info
- **2026-10-18** `8b964b9663dc`: 1 info
- **2026-10-18** `f487125c9f92`: 1 info
- **2026-10-18** `5a692f00e432`: 1 info
- **2026-10-16** `35f4b82bace1`: 1 info
- **2026-10-16** `e27fe0c3b5e0`: 1 info
- **2026-10-15** `986f6f08390d`: 1 info
- **2026-10-15** `0099a1a884ed`: 1 info
- **2026-10-15** `715bf4305d7e`: 1 info
- **2026-06-04** `07b076404433`: 1 warning, 13 info
- **2026-06-02** `81f56857e143`: 1 breaking, 13 warning, 2 info
- **2026-06-02** `bbd0d70989a7`: 1 breaking, 15 info
- **2026-05-27** `2e889aa00c82`: 1 info

## Changes

- **2026-10-23** `0b4e519a544f`: 1 info
  - added the non-success response with the status `401`
- **2026-10-23** `732aed62833a`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-22** `4f826b2c3a0e`: 1 info
  - added the non-success response with the status `401`
- **2026-10-22** `8f0dc569f247`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-21** `08b800d640e6`: 1 info
  - added the non-success response with the status `401`
- **2026-10-21** `3ce0047cb0a0`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-20** `509fb3426748`: 1 info
  - added the non-success response with the status `401`
- **2026-10-20** `fa3268994006`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-20** `5e1d272a28f3`: 1 info
  - added the non-success response with the status `401`
- **2026-10-20** `57adccdd4749`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-19** `403429a2fc35`: 1 info
  - added the non-success response with the status `401`
- **2026-10-18** `8b964b9663dc`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-18** `f487125c9f92`: 1 info
  - added the non-success response with the status `401`
- **2026-10-18** `5a692f00e432`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-16** `35f4b82bace1`: 1 info
  - added the non-success response with the status `401`
- **2026-10-16** `e27fe0c3b5e0`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-15** `986f6f08390d`: 1 info
  - added the non-success response with the status `401`
- **2026-10-15** `0099a1a884ed`: 1 info
  - removed the non-success response with the status `401`
- **2026-10-15** `715bf4305d7e`: 1 info
  - added the non-success response with the status `401`
- **2026-06-04** `07b076404433`: 1 warning, 13 info
  - removed the request property `skill_id`
  - the response property `skill` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/created_at` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/created_by_id` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/description` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/display_name` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/instructions` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/path` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/project_id` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/skill_id` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/tags` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/updated_at` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/updated_by_id` became required for the status `200`
  - the response property `skill/allOf[#/components/schemas/Skill]/version` became required for the status `200`
- **2026-06-02** `81f56857e143`: 1 breaking, 13 warning, 2 info
  - the `skill` response's property type changed from `object` to no type for status `200`
  - removed the optional property `skill/created_at` from the response with the `200` status
  - removed the optional property `skill/created_by_id` from the response with the `200` status
  - removed the optional property `skill/description` from the response with the `200` status
  - removed the optional property `skill/display_name` from the response with the `200` status
  - removed the optional property `skill/instructions` from the response with the `200` status
  - removed the optional property `skill/path` from the response with the `200` status
  - removed the optional property `skill/project_id` from the response with the `200` status
  - removed the optional property `skill/skill_id` from the response with the `200` status
  - removed the optional property `skill/tags` from the response with the `200` status
  - removed the optional property `skill/updated_at` from the response with the `200` status
  - removed the optional property `skill/updated_by_id` from the response with the `200` status
  - removed the optional property `skill/version` from the response with the `200` status
  - removed the optional property `skill/workspace_id` from the response with the `200` status
  - api tag `SkillsService` removed
  - added `#/components/schemas/Skill` to the `skill` response property `allOf` list for the response status `200`
- **2026-06-02** `bbd0d70989a7`: 1 breaking, 15 info
  - the `skill` response's property type changed from no type to `object` for status `200`
  - api tag `SkillsService` added
  - added the optional property `skill/created_at` to the response with the `200` status
  - added the optional property `skill/created_by_id` to the response with the `200` status
  - added the optional property `skill/description` to the response with the `200` status
  - added the optional property `skill/display_name` to the response with the `200` status
  - added the optional property `skill/instructions` to the response with the `200` status
  - added the optional property `skill/path` to the response with the `200` status
  - added the optional property `skill/project_id` to the response with the `200` status
  - added the optional property `skill/skill_id` to the response with the `200` status
  - added the optional property `skill/tags` to the response with the `200` status
  - added the optional property `skill/updated_at` to the response with the `200` status
  - added the optional property `skill/updated_by_id` to the response with the `200` status
  - added the optional property `skill/version` to the response with the `200` status
  - added the optional property `skill/workspace_id` to the response with the `200` status
  - removed `#/components/schemas/Skill` from the `skill` response property `allOf` list for the response status `200`
- **2026-05-27** `2e889aa00c82`: 1 info
  - api tag `SkillsService` removed

---

[Operation](https://skmtc.dev/orq-ai/apis/orq-ai-api/docs/v2/skills/:skill_id/patch.md) - [API](https://skmtc.dev/orq-ai/apis/orq-ai-api.md) - [Page](https://skmtc.dev/orq-ai/apis/orq-ai-api/changes/v2/skills/:skill_id/patch)
