# /systems/{id}/alerts/silences - Create a silence for a system alert

**POST /systems/{id}/alerts/silences**

Creates an Alertmanager silence for a specific active alert on the target system.
The request identifies the live alert by fingerprint. The backend resolves the alert,
builds the silence matchers server-side, and always uses the system's authoritative
`system_key`.
If `end_at` is provided it takes precedence over `duration_minutes`.
Requires `manage:systems` permission.



## Servers
- Backend API server: https://my.nethesis.it/backend/api (Backend API server)


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **id** (string)
  System ID (database UUID)



### 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 silence 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 silence created successfully

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

- **message** (string)

- **data** (object)


### 400
Validation failed. `data.type` is always `validation_error`.
`data.errors[]` lists per-field failures with stable `message`
codes the UI consumes for i18n: `required` (missing field),
`invalid_format` (bad fingerprint regex or non-RFC3339 end_at),
`must_be_future` (end_at in the past), `max` / `min` (out of
range duration_minutes).


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