Update Check

Modify settings for a check. The provided settings will overwrite previous values. Settings not provided will stay the same as before the update. To clear an existing value, provide an empty value. Please note that you cannot change the type of a check once it has been created.

Basic Parameters

Parameter	Description
Check IDs	Identifiers of checks to modify in bulk. For example checkids=1234,5678.
Host	Target host.
Name	Check name.
Resolution	How often should the check be tested? (minutes).
check ID	Identifier of check to be updated.

Advanced Parameters

Parameter	Description
Add Tags	Check tags to add in addition to current check tags.
Auth	Username and password, colon separated.
Custom Message	Custom message that will be added to email and webhook alerts.
Encryption	Connection encryption.
IPv6	Use ipv6 instead of ipv4, if an IP address is provided as host this will be overrided by the IP address version.
Integration IDs	Integration identifiers. For example integrationids:[1,2,3].
Notify Again Every	Notify again every n result. 0 means that no extra notifications will be sent.
Notify When Backup	Notify when back up again.
Paused	-
Port	Target port.
Post Data	Data that should be posted to the web page, for example submission data for a sign-up or login form. The data needs to be formatted in the same way as a web browser would send it to the web server.
Probe Filters	Filters used for probe selections. Overwrites previous filters for check. To remove all filters from a check, use an empty value. Comma separated key:value pairs. Currently only region is supported. Possible values are ‘EU’, ‘NA’, ‘APAC’ and ‘LATAM’. For example, “region: NA”.
Request Headers	Custom HTTP header. The entry value should contain a one-element string array. The element should contain headerName and headerValue colon-separated. To add more than one header send other parameters named requestheaders{number}.
Response Time Threshold	Triggers a down alert if the response time exceeds threshold specified in ms (Not available for Starter and Free plans.).
SSL Down Days Before	Treat the target site as down if a certificate expires within the given number of days. This parameter will be ignored if verify_certificate is set to false.
Send Notification When Down	Send notification when down X times.
Should Contain	Target site should contain this string. Note! This parameter cannot be used together with the parameter “shouldnotcontain”, use only one of them in your request.
Should Not Contain	Target site should NOT contain this string. Note! This parameter cannot be used together with the parameter “shouldcontain”, use only one of them in your request.
Tags	List of tags for check. The maximum length of a tag is 64 characters.
Team IDs	Teams to alert. Comma separated Integers.
URL	Path to target on server.
User iDs	User identifiers. For example userids=154325,465231,765871.
Verify Certificate	Treat target site as down if an invalid/unverifiable certificate is found.

Example Output

{
	"message": "Modification of check was successful!"
}

Workflow Library Example

Update Check with Pingdom and Send Results Via Email

Preview this Workflow on desktop