Skip to content

Get tenant alertmanager configuration API Reference

GET
/tenants/{tenant}/alertmanager/config

Returns the full Mimir Alertmanager wrapper for the tenant. The response includes the embedded alertmanager_config (parsed receivers/routes/global) and any template files. Use the section endpoints (/receivers, /routes, /global) for individual edits.

tenant
required
string

Tenant name

Current configuration

object
global

Global is the parsed global section (free-form).

object
key
additional properties
receivers

Receivers is the parsed receiver list.

Array<object>
object
email_configs
Array<object>
object
key
additional properties
name
string
Example
slack
slack_configs
Array<object>
object
key
additional properties
webhook_configs
Array<object>
object
key
additional properties
route

Route is the parsed root route.

object
active_time_intervals
Array<string>
continue
boolean
group_by
Array<string>
Example
[
"alertname",
"cluster"
]
group_interval
string
Example
5m
group_wait
string
Example
30s
match
object
key
additional properties
string
match_re
object
key
additional properties
string
matchers
Array<string>
Example
[
"severity=\"critical\""
]
mute_time_intervals
Array<string>
receiver
string
Example
slack
repeat_interval
string
Example
4h
templates

Templates maps a template filename to its contents.

object
key
additional properties
string
ETag
string

Wrapper ETag for optimistic locking

Missing or invalid authentication

object
code
string
error
string
field
string
message
string
severity
string

Not a member of this tenant

object
code
string
error
string
field
string
message
string
severity
string

Alertmanager proxy not enabled in this deployment

object
code
string
error
string
field
string
message
string
severity
string

Tenant credentials not yet available

object
code
string
error
string
field
string
message
string
severity
string