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

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

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

## Path parameters

- `project_id` integer, required
- `ref` string, required

## Request body

- EditIssueRequestBody
  - `actor` string
  - `body` string
  - `clear_priority` boolean
  - `links_delta` LinksDelta
    - `add_blocked_by` string[], nullable
    - `add_blocks` string[], nullable
    - `add_related` string[], nullable
    - `remove_blocked_by` string[], nullable
    - `remove_blocks` string[], nullable
    - `remove_parent` string
    - `remove_related` string[], nullable
    - `set_parent` string
  - `owner` string
  - `set_priority` integer
  - `title` string

## Response `200`

OK

- EditIssueResponseBody
  - `changed` boolean, required
  - `changes` LinkChanges
    - `blocked_by_added` LinkPeer[], nullable
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `blocked_by_removed` LinkPeer[], nullable
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `blocks_added` LinkPeer[], nullable
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `blocks_removed` LinkPeer[], nullable
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `parent_removed` LinkPeer
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `parent_set` LinkPeer
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `related_added` LinkPeer[], nullable
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
    - `related_removed` LinkPeer[], nullable
      - `project` string, required
      - `qualified_id` string, required
      - `short_id` string, required
      - `status` string, required
      - `uid` string, required
  - `event` Event, required
    - `actor` string, required
    - `content_hash` string, required
    - `created_at` string, date-time, required
    - `hlc_counter` integer, required
    - `hlc_physical_ms` integer, required
    - `id` integer, required
    - `issue_id` integer
    - `issue_short_id` string
    - `issue_uid` string
    - `origin_instance_uid` string, required
    - `payload` string, required
    - `project_id` integer, required
    - `project_name` string, required
    - `project_uid` string, required
    - `related_issue_id` integer
    - `related_issue_short_id` string
    - `related_issue_uid` string
    - `type` string, required
    - `uid` string, required
  - `events` Event[], nullable
    - `actor` string, required
    - `content_hash` string, required
    - `created_at` string, date-time, required
    - `hlc_counter` integer, required
    - `hlc_physical_ms` integer, required
    - `id` integer, required
    - `issue_id` integer
    - `issue_short_id` string
    - `issue_uid` string
    - `origin_instance_uid` string, required
    - `payload` string, required
    - `project_id` integer, required
    - `project_name` string, required
    - `project_uid` string, required
    - `related_issue_id` integer
    - `related_issue_short_id` string
    - `related_issue_uid` string
    - `type` string, required
    - `uid` string, required
  - `issue` Issue, required
    - `author` string, required
    - `body` string, required
    - `closed_at` string, date-time
    - `closed_reason` string
    - `created_at` string, date-time, required
    - `deleted_at` string, date-time
    - `id` integer, required
    - `metadata` object, required
    - `occurrence_key` string
    - `owner` string
    - `priority` integer
    - `project_id` integer, required
    - `project_uid` string
    - `recurrence_id` integer
    - `revision` integer, required
    - `short_id` string, required
    - `status` string, required
    - `title` string, required
    - `uid` string, required
    - `updated_at` string, date-time, required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/kenn-io/apis/kata.md) · [All operations](https://skmtc.net/kenn-io/apis/kata/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kenn-io/kata/versions/14560b7a29ca/schema)