---
title: "Trigger DNS Check"
description: "Triggers an immediate DNS check across eligible monitoring locations."
---

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

## Example (cURL)

```bash
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

```json
{
  "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)
- `503 No active monitoring locations available`