Re-check a domain's DNS records
verify_domainRe-checks a domain's public DNS records and reports which required records are present, showing pending status while propagation completes rather than treating it as a failure.
Instructions
Purpose: re-read the public DNS for a domain and report which records are in place. NOT for: creating records. Publishing DNS is done wherever the domain is hosted, by whoever runs it. Returns: the same domain view GET /domains/:id returns after the check — every record with status, host, value_strings, required and observed. A domain with nothing published yet stays pending rather than failing: DNS takes minutes to a day or two to spread, and calling that a failure would make you give up on a domain that is about to work. Pass the domain id or the domain name as domain_id. id and name mean the same thing.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"domain_id": "<domain_id>"
},
"name": "verify_domain"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain_id | Yes | The domain id or the domain name. name is an alias for this argument. | |
| idempotency_key | No | Your own key for this action. Retrying with the same key returns the first result instead of doing it twice — send one whenever a retry could double the effect. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Identifier. | |
| name | No | ||
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| region | No | ||
| status | No | pending, verified, failed or temporary_failure. | |
| records | No | Each DNS record with its status. | |
| tls_mode | No | opportunistic or enforced. |