Skip to main content
POST
Create an Alertmanager silence

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

authorization
string | null
x-ankra-organisation-id
string | null

Path Parameters

cluster_id
string<uuid4>
required

Body

application/json
matchers
AlertmanagerSilenceMatcher · object[]
required

Every matcher must match for an alert to be silenced; at least one must be an exact match.

Minimum array length: 1
comment
string
required

Why the alerts are silenced; operators see it in Alertmanager.

Maximum string length: 1000
duration
string | null
default:2h

How long the silence lasts: a number and a unit (s, m, h, d, w), from 5m to 30d.

namespace
string | null

Namespace of the Alertmanager Service; alone it narrows discovery.

service
string | null

Name of the Alertmanager Service, for installs discovery does not find. Needs namespace.

port
integer | null
default:9093

Port Alertmanager listens on.

Response

Silence created

silence_id
string
required
matchers
AlertmanagerSilenceMatcher · object[]
required
starts_at
string
required
ends_at
string
required
created_by
string
required
comment
string
required
alertmanager
AlertmanagerTarget · object
required

The in-cluster Alertmanager the call went to.