---
title: "Changes to PATCH /api/v1/projects/{project_id}/issues/{ref}"
method: PATCH
path: "/api/v1/projects/{project_id}/issues/{ref}"
---

# Changes to PATCH /api/v1/projects/{project_id}/issues/{ref}

`PATCH /api/v1/projects/{project_id}/issues/{ref}`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 9 of 70 revisions.

- **2026-10-14** `c5792dd95eca`: 5 info
- **2026-09-19** `62eb7bbfff42`: 1 info
- **2026-09-08** `f0017a33d9be`: 3 info
- **2026-09-05** `12b3e0f9f6ad`: 6 breaking
- **2026-08-15** `d111dd43f594`: 1 info
- **2026-08-05** `1a5a27920493`: 1 info
- **2026-07-09** `987b717e44b2`: 8 info
- **2026-06-16** `88357e9777d5`: 16 info
- **2026-06-05** `783ece1efda1`: 24 breaking

## Changes

- **2026-10-14** `c5792dd95eca`: 5 info
  - added the optional property `issue/accountable_actor` to the response with the `200` status
  - added the optional property `issue/authority_uid` to the response with the `200` status
  - added the optional property `issue/source_actor` to the response with the `200` status
  - added the optional property `issue/teammate` to the response with the `200` status
  - added the optional property `issue/verification` to the response with the `200` status
- **2026-09-19** `62eb7bbfff42`: 1 info
  - added the optional property `issue/assignment_expires_on` to the response with the `200` status
- **2026-09-08** `f0017a33d9be`: 3 info
  - added the new optional `header` request parameter `X-Kata-Project-Alias`
  - added the new optional `header` request parameter `X-Kata-Project-Alias-Kind`
  - for the `path` request parameter `project_id`, the type was generalized from `integer` to `string`, and format from `int64` to no format
- **2026-09-05** `12b3e0f9f6ad`: 6 breaking
  - the request property `links_delta/add_blocked_by` became not nullable
  - the request property `links_delta/add_blocks` became not nullable
  - the request property `links_delta/add_related` became not nullable
  - the request property `links_delta/remove_blocked_by` became not nullable
  - the request property `links_delta/remove_blocks` became not nullable
  - the request property `links_delta/remove_related` became not nullable
- **2026-08-15** `d111dd43f594`: 1 info
  - added the new optional request property `links_delta/expected_project_uids`
- **2026-08-05** `1a5a27920493`: 1 info
  - the request property `actor` became optional
- **2026-07-09** `987b717e44b2`: 8 info
  - added the required property `changes/blocked_by_added/items/status` to the response with the `200` status
  - added the required property `changes/blocked_by_removed/items/status` to the response with the `200` status
  - added the required property `changes/blocks_added/items/status` to the response with the `200` status
  - added the required property `changes/blocks_removed/items/status` to the response with the `200` status
  - added the required property `changes/parent_removed/status` to the response with the `200` status
  - added the required property `changes/parent_set/status` to the response with the `200` status
  - added the required property `changes/related_added/items/status` to the response with the `200` status
  - added the required property `changes/related_removed/items/status` to the response with the `200` status
- **2026-06-16** `88357e9777d5`: 16 info
  - added the required property `changes/blocked_by_added/items/project` to the response with the `200` status
  - added the required property `changes/blocked_by_added/items/qualified_id` to the response with the `200` status
  - added the required property `changes/blocked_by_removed/items/project` to the response with the `200` status
  - added the required property `changes/blocked_by_removed/items/qualified_id` to the response with the `200` status
  - added the required property `changes/blocks_added/items/project` to the response with the `200` status
  - added the required property `changes/blocks_added/items/qualified_id` to the response with the `200` status
  - added the required property `changes/blocks_removed/items/project` to the response with the `200` status
  - added the required property `changes/blocks_removed/items/qualified_id` to the response with the `200` status
  - added the required property `changes/parent_removed/project` to the response with the `200` status
  - added the required property `changes/parent_removed/qualified_id` to the response with the `200` status
  - added the required property `changes/parent_set/project` to the response with the `200` status
  - added the required property `changes/parent_set/qualified_id` to the response with the `200` status
  - added the required property `changes/related_added/items/project` to the response with the `200` status
  - added the required property `changes/related_added/items/qualified_id` to the response with the `200` status
  - added the required property `changes/related_removed/items/project` to the response with the `200` status
  - added the required property `changes/related_removed/items/qualified_id` to the response with the `200` status
- **2026-06-05** `783ece1efda1`: 24 breaking
  - removed the required property `changes/blocked_by_added/items/project` from the response with the `200` status
  - removed the required property `changes/blocked_by_added/items/qualified_id` from the response with the `200` status
  - removed the required property `changes/blocked_by_added/items/status` from the response with the `200` status
  - removed the required property `changes/blocked_by_removed/items/project` from the response with the `200` status
  - removed the required property `changes/blocked_by_removed/items/qualified_id` from the response with the `200` status
  - removed the required property `changes/blocked_by_removed/items/status` from the response with the `200` status
  - removed the required property `changes/blocks_added/items/project` from the response with the `200` status
  - removed the required property `changes/blocks_added/items/qualified_id` from the response with the `200` status
  - removed the required property `changes/blocks_added/items/status` from the response with the `200` status
  - removed the required property `changes/blocks_removed/items/project` from the response with the `200` status
  - removed the required property `changes/blocks_removed/items/qualified_id` from the response with the `200` status
  - removed the required property `changes/blocks_removed/items/status` from the response with the `200` status
  - removed the required property `changes/parent_removed/project` from the response with the `200` status
  - removed the required property `changes/parent_removed/qualified_id` from the response with the `200` status
  - removed the required property `changes/parent_removed/status` from the response with the `200` status
  - removed the required property `changes/parent_set/project` from the response with the `200` status
  - removed the required property `changes/parent_set/qualified_id` from the response with the `200` status
  - removed the required property `changes/parent_set/status` from the response with the `200` status
  - removed the required property `changes/related_added/items/project` from the response with the `200` status
  - removed the required property `changes/related_added/items/qualified_id` from the response with the `200` status
  - removed the required property `changes/related_added/items/status` from the response with the `200` status
  - removed the required property `changes/related_removed/items/project` from the response with the `200` status
  - removed the required property `changes/related_removed/items/qualified_id` from the response with the `200` status
  - removed the required property `changes/related_removed/items/status` from the response with the `200` status

---

[Operation](https://skmtc.dev/kenn-io/apis/kata/docs/api/v1/projects/:project_id/issues/:ref/patch.md) - [API](https://skmtc.dev/kenn-io/apis/kata.md) - [Page](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/projects/:project_id/issues/:ref/patch)
