Skip to content

Create or update alertmanager receiver API Reference

PUT
/tenants/{tenant}/alertmanager/receivers/{name}
curl --request PUT \
--url https://api.kupe.cloud/api/v1/tenants/acme/alertmanager/receivers/slack \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "email_configs": [ { "additionalProperty": "example" } ], "name": "slack", "slack_configs": [ { "additionalProperty": "example" } ], "webhook_configs": [ { "additionalProperty": "example" } ] }'

Idempotent upsert. The path name is authoritative; the body’s name field is overridden. The receiver shape is the standard Alertmanager schema (slack_configs, email_configs, etc.).

tenant
required
string

Tenant name

name
required
string

Receiver name

If-Match
string

Wrapper ETag for optimistic locking

Receiver configuration

Media type application/json
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

Receiver after upsert

Media type application/json
object
email_configs
Array<object>
object
key
additional properties
name
string
slack_configs
Array<object>
object
key
additional properties
webhook_configs
Array<object>
object
key
additional properties
Example
{
"name": "slack"
}
ETag
string

New wrapper ETag

Validation error

Media type application/json
object
code
string
error
string
field
string
message
string
severity
string
Example generated
{
"code": "example",
"error": "example",
"field": "example",
"message": "example",
"severity": "example"
}

ETag mismatch

Media type application/json
object
code
string
error
string
field
string
message
string
severity
string
Example generated
{
"code": "example",
"error": "example",
"field": "example",
"message": "example",
"severity": "example"
}