# Create or update a silence

**POST /services/mimir/alertmanager/api/v2/silences**

Creates or updates a silence that targets this system's alerts.

The proxy automatically injects a `system_key` matcher for this system into the silence, overwriting any client-supplied `system_key` matcher. This ensures silences can only target this system's alerts.

**Access control:** Requires HTTP Basic Auth with valid system credentials.

**Silence matchers:** The silence must include at least one matcher (e.g., `alertname`). The `system_key` matcher is added automatically and cannot be customized.



## 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
- Basic auth


## Parameters



### Body: application/json (object)

object

## Responses
### 200
Silence created or updated successfully

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


### 413
Payload too large

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


### 502
Internal server error

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

- **message** (string)

- **data** (object | null)



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