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

# POST /api/v1/projects/{project_id}/issues/{ref}/notifications

`POST /api/v1/projects/{project_id}/issues/{ref}/notifications`

## Request

- The document declares no server URL.
- Auth: none declared

## Path parameters

- `project_id` string, required: Numeric project ID or name:<project name>; name: alone requires an alias
- `ref` string, required

## Headers

- `X-Kata-Project-Alias` string: Workspace alias identity; requires a name: selector
- `X-Kata-Project-Alias-Kind` string: Workspace alias kind; required with X-Kata-Project-Alias

## Request body

- NotifyIssueRequestBody
  - `actor` string
  - `broadcast` boolean
  - `message` string, required
  - `re` string
  - `teammate` string
  - `teammates` boolean
  - `to` string

## Response `200`

OK

- NotifyIssueResponseBody
  - `changed` boolean, required
  - `event` Event
    - `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
    - `accountable_actor` string
    - `assignment_expires_on` string, date-time
    - `author` string, required
    - `authority_uid` string
    - `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
    - `source_actor` string
    - `status` string, required
    - `teammate` string
    - `title` string, required
    - `uid` string, required
    - `updated_at` string, date-time, required
    - `verification` 'verified' | 'pending' | 'legacy'
  - `recipients` string[], required

## Other responses

- `default`: Error

## Changes

- **2026-10-23** `9386eebc7718`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kenn-io/apis/kata/changes/api/v1/projects/:project_id/issues/:ref/notifications/post.md)

---

[API](https://skmtc.dev/kenn-io/apis/kata.md) - [All operations](https://skmtc.dev/kenn-io/apis/kata/llms.txt) - [OpenAPI document](https://skmtc.dev/kenn-io/apis/kata/revisions/351807923500?raw)