# /alerts/silences - Mute an alert across systems

**POST /alerts/silences**

Cross-system parallel of `POST /systems/{id}/alerts/silences`. Mutes
an active alert identified by fingerprint inside a single tenant
(`?organization_id=`). The backend looks up the alert in Mimir,
extracts `system_key` from its labels, builds the matchers
server-side, and delegates to the same silence-creation path used by
the per-system endpoint — so the silence object stored in Mimir is
byte-identical regardless of which route created it.

If `end_at` is set it takes precedence over `duration_minutes`.

Requires `manage:systems` permission.



## 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)
  Tenant that owns the alert. Mandatory for every role except
  Customer (where it is ignored — they're always pinned to their
  own organization). Owners can address any tenant in the system.

### Body: application/json (object)

- **fingerprint** (string)
  Fingerprint of the active alert to silence.
- **comment** (string)
  Optional silence comment. Defaults to a system-generated value when empty.
- **duration_minutes** (integer)
  Optional duration in minutes. Defaults to 60 when omitted. Ignored when end_at is set.
- **end_at** (string(date-time))
  Optional explicit end time (RFC3339). Takes precedence over duration_minutes.


## Responses
### 200
Alert silenced successfully

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

- **message** (string)

- **data** (object)


### 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)


### 404
Resource not found

#### Body: application/json (object)
- **code** (integer)
  HTTP error code
- **message** (string)
  Error message
- **data** (object)



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