# Configure alert routing

**POST /alerts/config**

Accepts a generic AlertingConfig JSON, renders it into a valid Alertmanager YAML configuration,
and pushes it to Mimir. SMTP settings are injected server-side.
A built-in history webhook (ALERTING_HISTORY_WEBHOOK_URL) is always included and cannot be disabled.
Priority order: per-system overrides > per-severity overrides > global settings.
Address fallback: if an override's address list is empty, global addresses are used.



## 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)
  Target organization ID. Required for Owner, Distributor, and Reseller roles. Customer role uses their own organization automatically.

### Body: application/json (object)

- **mail_enabled** (boolean)
  Globally enable or disable email notifications
- **webhook_enabled** (boolean)
  Globally enable or disable custom webhook notifications
- **telegram_enabled** (boolean)
  Globally enable or disable Telegram notifications
- **mail_addresses** (array[string(email)])
  Global default email recipients
- **webhook_receivers** (array[object])
  Global default webhook receivers
- **telegram_receivers** (array[object])
  Global Telegram bot receivers
- **severities** (array[object])
  Per-severity overrides. Empty list = use global settings for all severities.
- **systems** (array[object])
  Per-system_key overrides (highest priority). Empty list = no per-system overrides.
- **email_template_lang** (string)
  Language for email and Telegram notification templates. "en" (English, default) or "it" (Italian).


## Responses
### 200
Alerting configuration updated

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


### 500
Internal server error

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

- **message** (string)

- **data** (object | null)



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