Sign in

v1

latestOpenAPI 3.0.02026-07-133916139.4 KB
monitor

Update an DNS monitor

put/monitor/dns/{id}

Path parameters

idstring required

The id of the monitor

Example:1

The id of the monitor

Request body

namestring required

Name of the monitor

descriptionstring
retrynumber

Number of retries to attempt

degradedAfternumber

Time in milliseconds to wait before marking the request as degraded

timeoutnumber

Time in milliseconds to wait before marking the request as timed out

frequency'30s' | '1m' | '5m' | '10m' | '30m' | '1h' required
activeboolean

Whether the monitor is active

publicboolean

Whether the monitor is public

regionsstring[] nullable

Where we should monitor it

Example request

{
  "regions": [
    "ams"
  ]
}

Response

Update a monitor

idnumber required

The id of the monitor

periodicity'30s' | '1m' | '5m' | '10m' | '30m' | '1h' | 'other' required

How often the monitor should run

urlstring required

The url to monitor

regionsstring[] nullable

Where we should monitor it

namestring required

The name of the monitor

externalNamestring nullable

The external name of the monitor, used to display on the status page or in the external notifications

descriptionstring nullable

The description of your monitor

method'GET' | 'POST' | 'HEAD' | 'PUT' | 'PATCH' | 'DELETE' | 'TRACE' | 'CONNECT' | 'OPTIONS' required
bodystring nullable

The body

activeboolean

If the monitor is active

publicboolean

If the monitor is public

degradedAfternumber nullable

The time after the monitor is considered degraded in milliseconds

timeoutnumber nullable

The timeout of the request in milliseconds

retrynumber

The number of retries to attempt

followRedirectsboolean

If the monitor should follow redirects

jobType'http' | 'tcp' | 'icmp' | 'udp' | 'dns' | 'ssl'

The type of the monitor

Example response

{
  "id": 123,
  "periodicity": "1m",
  "url": "https://www.documenso.co",
  "regions": [
    "ams"
  ],
  "name": "documenso-web",
  "externalName": "Documenso",
  "description": "Documenso website",
  "method": "GET",
  "body": "Hello World",
  "headers": [
    {
      "key": "x-apikey",
      "value": "supersecrettoken"
    }
  ]
}