Skip to content

Verify a custom domain's DNS

POST
/v1/domains/{id}/verify

Authorizations

apiKey

Scoped API key. Scopes are readwriteadmin. A call needing more scope than the key holds returns 403 insufficient_scope.

Type
HTTP (bearer)

Parameters

Path Parameters

id*
Type
string
Required

Responses

The domain's logical verification state after re-checking each expected DNS record, plus a per-record delta (expected vs found) so the UI can guide fixes.

application/json
JSON
{
  
"state": "string",
  
"records": [
  
  
{
  
  
  
"type": "CNAME",
  
  
  
"name": "hooks.acme.com",
  
  
  
"expected": "ingest.example.com",
  
  
  
"found": "ingest.example.com",
  
  
  
"state": "string"
  
  
}
  
]
}

Playground

Authorization
Variables
Key
Value

Samples

Powered by VitePress OpenAPI

Emithook · a Finnoto product