Pausing monitors and maintenances

Pausing monitors

Pausing monitors from the UI

If you want to pause monitors (for example during setup or testing) and not receive downtime alerts:

  • Go to Monitors.
  • Pick the monitor you want to pause.
  • Click Pause this monitor in the headline.
  • We will not monitor the endpoint host now.
  • If you want to start monitoring again, click Unpause monitor.

Pausing monitors using API

You can also use our Monitors API, endpoint PATCH /monitors, to pause your monitor using the REST API Call.

Request example:

Pause monitor Unpause monitor
curl --request PATCH \
  --url https://uptime.betterstack.com/api/v2/monitors/:monitor_id\
  --header "Authorization: Bearer $TEAM_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"paused": true}'
curl --request PATCH \
  --url https://uptime.betterstack.com/api/v2/monitors/:monitor_id\
  --header "Authorization: Bearer $TEAM_TOKEN" \
  --header 'Content-Type: application/json' \
  --data '{"paused": false}'

Scheduled maintenance window

Schedule maintenance window from the UI

Scheduled maintenance windows are used for times when you're expecting downtime to occur, and don't want to be alerted. This could be for example when running maintenance scripts in your infrastructure or provisioning a new infrastructure.

To add a maintenance window:

  • Go to Monitors.
  • Pick the monitor you want to add a maintenance window to.
  • Click Configure in the headline.
  • Click Advanced settings.
  • Enter your maintenance window time in the Maintenance window between section, and select the right time zone.
  • Click Save changes.

Schedule maintenance window using API

You can also use our Monitors API, endpoint PATCH /monitors, to schedule a maintenance window using the REST API Call.

Request example:

 
curl --request PATCH 'https://uptime.betterstack.com/api/v2/monitors/:monitor_id' \ 
--header 'Content-Type: application/json' \ 
--header "Authorization: Bearer $TEAM_TOKEN" \ 
--data-raw '{
"maintenance_from": "01:00:00", 
"maintenance_to": "03:00:00", 
"maintenance_timezone": "Prague"
}' 

Want to pause all monitors, heartbeats, and integrations for the whole team? Explore the Team-wide maintenance instead.

Want to only pause alerting for a single person? Explore using holiday mode instead.