Skip to main content

Verify Domain (DNS)

Checks for the expected TXT record on the dock’s domain to complete DNS verification.
POST /v1/docks/:id/domain/verify/dns

Path Parameters

ParameterTypeDescription
idstringThe dock ID

Request Body

ParameterTypeRequiredDescription
domainstringRequiredThe domain to verify

Example Request

curl -X POST https://api.docyard.io/v1/docks/dock_01HQ3K.../domain/verify/dns \
  -H "Authorization: Bearer dk_live_a1b2c3d4..." \
  -H "Content-Type: application/json" \
  -d '{ "domain": "acme-insurance.com" }'

Response

{
  "success": true,
  "message": "Domain verified successfully"
}

Error Handling

StatusCondition
400TXT record not found or does not match expected value
401Missing or invalid API key
404Dock not found