Uptimeify Docs
MonitorsDns monitors

Trigger DNS Check

Triggers an immediate DNS check across eligible monitoring locations.

POST /api/dns-monitors/:dnsMonitorPublicId/trigger-check

Example (cURL)

BASE_URL="https://uptimeify.io"
TOKEN="<your-api-token>"

curl -X POST \
  "$BASE_URL/api/dns-monitors/11111111-1111-4111-8111-111111111111/trigger-check" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept: application/json"

Example Response

{
  "success": true,
  "message": "Checks triggered successfully",
  "dnsMonitorId": 123,
  "locationCodes": ["de-nbg"],
  "queueNames": ["dns-monitor-checks-de-nbg"]
}

Common errors

  • 400 DNS monitor public ID (UUID) required
  • 401 Unauthorized
  • 403 Forbidden (requires write access)
  • 429 Check recently triggered (data.retryAfterMs) when the same monitor was triggered within the last 10 seconds
  • 503 No active monitoring locations available

List DNS Monitors

Lists DNS monitors for an organization (with pagination).

Update DNS Monitor

Updates a DNS monitor.

On this page

Example (cURL)Example ResponseCommon errors