# /alerts/notes - Append an operator note to an alert's timeline

**POST /alerts/notes**

Appends a free-form operator note (ticket links, findings, hand-over
info) to the alert's activity timeline as a `note_added` event. Notes
are independent from silences and assignments, immutable (append-only)
and can also target an alert that has already resolved — the timeline
outlives the alert, so no Mimir lookup is performed.

Notes are namespaced by organization: they are written under the
caller-resolved `organization_id` and only readable through that
organization's timeline.

Requires `manage:systems` permission on an organization in the caller's
hierarchy. Customers are pinned to their own organization.



## Servers
- Backend API server (port 8080): https://api.your-domain.com/api (Backend API server (port 8080))
- Collect API server (port 8081): https://collect.your-domain.com/api (Collect API server (port 8081))


## Authentication methods
- Bearer auth


## Parameters


### Query parameters

- **organization_id** (string)
  The alert's organization (its organization_id label). Required for
  Owner/Distributor/Reseller; ignored for Customer (pinned).


### Body: application/json (object)

- **fingerprint** (string)
  Alertmanager fingerprint of the alert

- **text** (string)
  Note text (trimmed; must not be blank)



## Responses
### 200
Note appended to the timeline

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 400
Bad request - validation error

#### Body: application/json (object)
- **code** (integer)
  HTTP error code

- **message** (string)
  Error message

- **data** (object)


### 401
Unauthorized - invalid or missing token

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)


### 403
Forbidden - insufficient permissions

#### Body: application/json (object)
- **code** (integer)

- **message** (string)

- **data** (object | null)



[Powered by Bump.sh](https://bump.sh)