---
title: "Re-check DNS delegation/records for a domain in pending_dns."
method: POST
path: "/byo-domains/{id}/poll-dns"
tags: ["byo-domains"]
---

# Re-check DNS delegation/records for a domain in pending_dns.

`POST /byo-domains/{id}/poll-dns`

## Request

- Base URL: `https://api.coldrig.dev`
- URL: `https://api.coldrig.dev/byo-domains/{id}/poll-dns`
- Auth: HTTP bearer

Poll-verify: advances pending_dns → active on success, or → abandoned after a 7-day idle timeout with no verification. A no-op (returns current state) once past pending_dns.

## Path parameters

- `id` string, required

## Response `200`

Poll result.

- PollDnsResult
  - `domainId` string, required
  - `byoStatus` 'pending_kyc' | 'pending_consent' | 'pending_dns' | 'active' | 'rejected' | 'abandoned', required
  - `verified` boolean, required
  - `checksSoFar` integer, required

## Other responses

- `401`: Missing, invalid, or inactive bearer token.
- `404`: Resource not found, or not owned by the authenticated account.

---

[API](https://skmtc.dev/coldrig/apis/agent-cold-email-api.md) · [All operations](https://skmtc.dev/coldrig/apis/agent-cold-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coldrig/apis/agent-cold-email-api/revisions/242a462d82c4?raw)