monitor.contact.edit

Edit a contact bind to a monitor. With this method you can change the delay and type of alert settings.

Authentication & Action

This method needs authentication. It can be accessed by http and https.

Action type: HTTP POST.

Arguments

monitor_id (required, see note 1)

The id of an existing monitor. Should be an integer.

monitor_name (required, see note 1)

The name of an existing monitor. Should be a string of max 64 chars.

contact_id (required, see note 2)

The id of an existing contact. Should be an integer.

contact_name (required, see note 2)

The name of an existing contact. Should be a string of max 64 chars.

delay (not required)

The delay before an alert is send. 0=immediately after error is found, 1 = after 1 check, 2 = after 2 checks etc... If the frequence of the monitor is 2 minutes, setting the delay to 3 will send an alert if the server is still on error after 3 checks (so after 6 minutes).  Should be an integer.

alert_type (not required)

There are 2 types of alerts. 'a' = alert on error, 'r' = alert on error AND when server is available again.  Allowed values: a = on error only / r = on error and when available again.

 

NOTE 1: For ease of use, it is possible to use both monitor_id and monitor_name as a key. If both are present, the monitor_id is taken as the key.

 

NOTE 2: For ease of use, it is possible to use both contact_id and contact_name as a key. If both are present, the contact_id is taken as the key.

Example Request

http://api.webcron.org/monitor.contact.edit
contact_id=1983&monitor_id=52319&delay=4&alert_type=a

Example Response

<rsp status="ok">
   <changed contact_id="1983" monitor_id="52319" />
</rsp>