Sign in
latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-2183295744.1 KB

d3689bca6458

domains

Verify domain

Restart verification for a custom domain.

Address the domain by its ID or by its name. Names are unique per workspace, so api.acme.com is enough.

Call this after you correct the DNS records of a domain that shows failed, or to give a pending domain a new 24-hour verification period. The domain goes back to pending and the 24-hour period starts again.

The endpoint returns when Unkey accepts the retry. Poll domains.getDomain for the result.

A domain that is already verified returns a 412.

Required Permissions

Your root key must have one of the following permissions:

  • environment.*.verify_domain (to verify domains in any environment)
  • environment.<environment_id>.verify_domain (to verify domains in a specific environment)
post/v2/domains.verifyDomain

Request body

domainstring required

Identifies a domain by its name or by its ID. Send the fully qualified domain name, such as 'api.acme.com', without a scheme, port, or path, or send the domain ID that domains.createDomain returns. You can send an internationalized name in Unicode or in Punycode form. Both forms address the same domain.

Example request

{
  "domain": "api.acme.com"
}

Response

Verification retry accepted. The workflow runs in the background.

dataEmptyResponse required

Empty response object by design. A successful response indicates this operation was successfully executed.

Example response

{
  "meta": {
    "requestId": "req_123"
  }
}