Update a website's uptime settings
Changes how one website is monitored. Send only the fields you want to change, and at least one.
keyword and redirects merge field by field over the stored section, so a partial object keeps the fields you do not send. keyword.keys is the only field replaced whole rather than merged.
It does not change the global configuration itself (interval, timeout): use “Update an uptime global configuration”.
Body
status(enabledordisabled, optional): turns monitoring on or pauses it. Enabling runs a check right away.preset(integer, optional): id of another Uptime Monitor global configuration to move the website to. The website keeps its status, unlike “Assign websites to an uptime global configuration”, which always switches it on.keyword(object, optional):status(enabledordisabled, optional): turns the keyword check on or off. An enabled keyword check needs at least one keyword.type(someorevery, optional): plan-dependent.keys(array of strings, optional): the keywords.
path(string ornull, optional): path checked on the website, for example/status;nullchecks the website root.redirects(object, optional):status(enabledordisabled, optional): turns the redirect check on or off.max_redirects(integer, optional): 1 to 10.expected_url(URL ornull, optional): the URL the redirects must end on;nullaccepts any.
Errors
- 422: no field is sent, or
redirects.expected_urlis not a valid URL.
Authentication
Personal access token created in the Modular DS dashboard; read-only tokens can only call GET endpoints.
Path parameters
Query parameters
Relations to add to the answer, comma separated: preset (the global configuration the website uses) and current_change (the current status change). Without include both are answered; an include narrows the answer to the ones it names, and an empty include= answers none. Any other name, including the camelCase currentChange, answers 400.
Request
Response
200 - Uptime service updated
