UserView based devices can be edited only using special EveryStep Scripting Tool.

A Device edit request consists of the same data you get when you pull out device info. It can be processed according to your goals and send back to the same Device URI using POST method.

Request URL

POST  https://api.dotcom-monitor.com/config_api_v1/device/{device_id}

Path Parameters

Field Type Required Description
device_id

string

true

The unique id of a monitoring device.

To see a device id from within your dotcom-monitor account, open the target device in the Device Manager list to edit. In the browser’s address bar you’ll see something like:

https://user.dotcom-monitor.com/ClientID/DeviceEdit?pid=dc7f4ff2ca944dekjh1078b96707002&deviceId=63698&taskId=132834

The deviceId=63698 is the task id.

Header Parameters

Content-Type: application/json
Example Post body
{
    "Avoid_Simultaneous_Checks":false,
    "False_Positive_Check":false,
    "Locations":[1,2,4,5,8],
    "Send_Uptime_Alert":true,
    "Status_Description":"ACTIVE",
    "Postpone":false,
    "Owner_Device_Id":8534,
    "Frequency":60,
    "Filter_Id":1091,
    "Scheduler_Id":832,
    "Notifications":
    {
        "E_Mail_Flag":true,
        "E_Mail_Address":"example@email.com",
        "E_Mail_TimeInterval_Min":20,
        "Notification_Groups":
        [
           {
                "Id":608,
                "Time_Shift_Min":10
           },
           {
                "Id":609,
                "Time_Shift_Min":20
           },
           {
                "Id":613,
                "Time_Shift_Min":0
           }
        ]
    },
    "Platform_Id":1,
    "Name":"new name"
}

Body Parameters

Find the description of common fields in the API: Device Methods Overview.

Success Response

Example response
{
    "Success":true,
    "Result":"Device 8533 has been updated"
}