Assign websites to an uptime global configuration

POST

https://api.modulards.com/api/public/v1/preset-uptimes/:preset_uptime/sites/sync

POST

/api/public/v1/preset-uptimes/:preset_uptime/sites/sync

curl -X POST https://api.modulards.com/api/public/v1/preset-uptimes/preset_uptime/sites/sync \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "sites": [
    101,
    102
  ]
}'

200Assign websites to an uptime global configuration

{
  "jsonapi": {
    "version": "1.1"
  },
  "meta": {
    "skipped": [
      {
        "message": "This website already uses this Uptime Monitor global configuration.",
        "reason_code": "ALREADY_APPLIED",
        "site_id": 102,
        "site_name": "Attached",
        "site_preset_uptime_id": 731
      }
    ],
    "status": "applied",
    "updated": [
      {
        "site_id": 101,
        "site_name": "Fresh",
        "site_preset_uptime_id": 553
      }
    ]
  }
}

Assigns the websites you list in sites to one Uptime Monitor global configuration. The change is immediate: the answer lists the websites that changed and the ones left out, so there is nothing to follow up.

What happens to each website:

A website with no configuration starts being monitored with this one. A website that used another one moves to this one.
Every assigned website is left with monitoring enabled, even if it was paused, and its first check runs right away. To change the configuration of one website and keep it paused, use “Update a website’s uptime settings” instead.
Websites you do not list are never unassigned: a website leaves a configuration by moving to another one.
A website that already uses this configuration (ALREADY_APPLIED), or that your token cannot reach (PERMISSION_DENIED, with a null site_name), is reported in meta.skipped with a reason_code and a message instead of failing the call.

Each website in meta.updated carries site_preset_uptime_id, the id that “Retrieve a website’s uptime settings” and “Update a website’s uptime settings” take.

Body

sites (array of integers, required): ids of the websites to act on, 1 to 50.

Errors

422: an id that is not a website.

Authentication

AuthorizationBearer

Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.

Path parameters

preset_uptimestringRequired

Request

This endpoint expects an object.

siteslist of doublesOptional

Response

200 - Websites assigned, one skipped

jsonapiobjectOptional

metaobjectOptional