Skip to main content
POST
/
monitors
/
downtimes
Create a new monitor downtime
curl --request POST \
  --url https://api.eu.bronto.io/monitors/downtimes \
  --header 'Content-Type: application/json' \
  --header 'X-BRONTO-API-KEY: <api-key>' \
  --data '
{
  "name": "Business hours",
  "description": "Silence alerts outside of business hours",
  "from": [
    "550e8400-e29b-41d4-a716-446655440000",
    "297bb888-83b1-44e0-8ab6-47879f1275a2"
  ],
  "static_time_range": {
    "from": 1770641687992,
    "to": 1770651667992
  },
  "suppress_recovery_alert": false,
  "alert_strategy": "DELAY"
}
'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "Business hours",
  "description": "Silence alerts outside of business hours",
  "from": [
    "550e8400-e29b-41d4-a716-446655440000",
    "297bb888-83b1-44e0-8ab6-47879f1275a2"
  ],
  "static_time_range": {
    "from": 1770641687992,
    "to": 1770651667992
  },
  "suppress_recovery_alert": false,
  "alert_strategy": "DELAY",
  "dynamic_time_range": {
    "from_minute_of_day": 540,
    "to_minute_of_day": 1020,
    "invert": false,
    "repeat_days": []
  }
}

Authorizations

​
X-BRONTO-API-KEY
string
header
required

Body

application/json
​
name
string
required

The name of the monitor downtime

Required string length: 1 - 255
Example:

"Business hours"

​
description
string
required

Extra contextual information to add to the downtime

Required string length: 1 - 4000
Example:

"Silence alerts outside of business hours"

​
from
string[]
required

List of monitor IDs to be affected by the downtime

Example:
[
  "550e8400-e29b-41d4-a716-446655440000",
  "297bb888-83b1-44e0-8ab6-47879f1275a2"
]
​
static_time_range
object
required
​
suppress_recovery_alert
boolean
default:false

When a monitor alerts outside of a downtime window but subsequently recovers within a downtime, by default the first recovery alert is allowed. Setting this flag to "true" forces these recovery alerts to also be suppressed.

​
alert_strategy
enum<string>
default:DELAY

How to handle alerts triggered during the downtime; "DELAY" alerts until the downtime ends, or "DROP" alerts entirely during the downtime.

Available options:
DELAY,
DROP
Example:

"DELAY"

​
dynamic_time_range
object

Response

Downtime is created successfully

​
id
string<uuid>
required

The unique identifier for the monitor downtime

​
name
string
required

The name of the monitor downtime

Required string length: 1 - 255
Example:

"Business hours"

​
description
string
required

Extra contextual information to add to the downtime

Required string length: 1 - 4000
Example:

"Silence alerts outside of business hours"

​
from
string[]
required

List of monitor IDs to be affected by the downtime

Example:
[
  "550e8400-e29b-41d4-a716-446655440000",
  "297bb888-83b1-44e0-8ab6-47879f1275a2"
]
​
static_time_range
object
required
​
suppress_recovery_alert
boolean
default:false

When a monitor alerts outside of a downtime window but subsequently recovers within a downtime, by default the first recovery alert is allowed. Setting this flag to "true" forces these recovery alerts to also be suppressed.

​
alert_strategy
enum<string>
default:DELAY

How to handle alerts triggered during the downtime; "DELAY" alerts until the downtime ends, or "DROP" alerts entirely during the downtime.

Available options:
DELAY,
DROP
Example:

"DELAY"

​
dynamic_time_range
object