v49

latestOpenAPI 3.1.0Proprietaryraw.githubusercontent.com2026-02-185890337.1 KB
Domains

Verify domain DNS

Check if DNS records are correctly configured and verify the domain. Returns the current status of each required DNS record.

Call this after you've added the DNS records shown when creating the domain.

post/tenants/{tenantId}/domains/{domainId}/verify

Path parameters

tenantIdstring required

The tenant ID

domainIdstring required

Domain ID

Response

Verification result

successtrue required

Example response

{
  "data": {
    "id": 123,
    "uuid": "550e8400-e29b-41d4-a716-446655440000",
    "name": "example.com",
    "verified": true,
    "verifiedAt": "2024-01-15T10:30:00Z",
    "dnsRecords": {
      "zone": "example.com",
      "spf": {
        "type": "TXT",
        "name": "ark-xyz._domainkey",
        "fullName": "ark-xyz._domainkey.example.com",
        "value": "v=spf1 include:spf.arkhq.io ~all",
        "status": "OK"
      },
      "dkim": {
        "type": "TXT",
        "name": "ark-xyz._domainkey",
        "fullName": "ark-xyz._domainkey.example.com",
        "value": "v=spf1 include:spf.arkhq.io ~all",
        "status": "OK"
      },
      "returnPath": {
        "type": "TXT",
        "name": "ark-xyz._domainkey",
        "fullName": "ark-xyz._domainkey.example.com",
        "value": "v=spf1 include:spf.arkhq.io ~all",
        "status": "OK"
      }
    },
    "createdAt": "2024-01-10T08:00:00Z",
    "tenant_id": "cm6abc123def456",
    "tenant_name": "Acme Corp"
  },
  "meta": {
    "requestId": "req_V1StGXR8_Z5jdHi6"
  }
}