Documentation forPingdom

Maintenance Windows

We have a feature that allows you to pause your checks at pre-set times, which pauses both the monitoring and alerting. This feature is available on the Advanced subscription plan or above. You can set this up from under Experience Monitoring > Maintenance in My Pingdom.

Here is how to set up a maintenance window:

  • Navigate to the above mentioned page
  • Click "Add maintenance"
  • Enter a name for this maintenance period

If it's a one off maintenance window:

  • Select a date and start time
  • Select a duration in minutes or hoursScreen_Shot_2019-06-12_at_15.09.22.png

If it's a repeating maintenance window:

  • Select the type of repeat pattern you want: daily, Wednesday every week, 2nd Wednesday of every month or a Custom pattern
  • If custom: Set the desired frequency of the maintenance window
  • Select an end date
  • Tick the boxes beside each of the checks (sites) that you want to include
  • Double-check your settings (always good to do!)
  • Click the green "Save" button at the bottom right.Screen_Shot_2019-06-12_at_15.13.39.png

Here are some command line and python options that you also can use to pause your checks, these uses our API which is available to all subscription plans.

cURL pause multiple checks:

curl -L -H "app-key: <APP_KEY>" -X PUT -u "<USERNAME>:<PASSWORD>" ";checkids=<CHECKID1>,<CHECKID2>,<CHECKID3>"

cURL unpause multiple checks:

curl -L -H "app-key: <APP_KEY>" -X PUT -u "<USERNAME>:<PASSWORD>" ";checkids=<CHECKID1>,<CHECKID2>,<CHECKID3>"


"""Pause a Pingdom check using Python."""
import requests
import json
# Set the check IDs you want to pause here by changing CHECKID*<br/>CHECKS = ','.join([CHECKID1, CHECKID2, CHECKID3])
# Set your app-key here
HEADERS = {'app-key': 'APP_KEY'}
# Set your username and password here
AUTH = ('username', 'password')
# Here we set up everything
URL = '
'paused': 'true',
'checkids': CHECKS
# Here we execute the request
R = requests.put(URL, auth=AUTH, headers=HEADERS, params=PARAMS)
# We build a new dict of the returned data
response_data = {'headers': dict(R.headers)}
response_data.update({'status_code': R.status_code})
response_data.update({'body': R.json()})
print(json.dumps(response_data, indent=2, sort_keys=True))