SynqDocs
Management APIDomains

Verify a domain now

Reads the domain's TXT record through public DNS now. When every public resolver that answers sees it, and no other org holds the name, the domain is `verified`; otherwise it stays as it was, and `problem` says why. A verified domain is also read again every day. Six times a minute for a domain. Needs `org.sso.edit` across the org and a plan with `team.sso`. Recorded as `org_domain.verified` when it verifies.

POST/v1/orgs/{org}/domains/{domain}/verify

Reads the domain's TXT record through public DNS now. When every public resolver that answers sees it, and no other org holds the name, the domain is verified; otherwise it stays as it was, and problem says why. A verified domain is also read again every day. Six times a minute for a domain. Needs org.sso.edit across the org and a plan with team.sso. Recorded as org_domain.verified when it verifies.

Authorization

bearer
AuthorizationBearer <token>

An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.

In: header

Path Parameters

org*string

The org's id

Match^org_[0-9a-hjkmnp-tv-z]{26}$
domain*string

The domain's id

Match^odm_[0-9a-hjkmnp-tv-z]{26}$

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/domains/odm_01h455vb4pex5vsknk084sn02q/verify" \  -H "Authorization: Bearer $SYNQ_API_KEY"
{  "id": "odm_01h455vb4pex5vsknk084sn02q",  "domain": "acme.com",  "status": "pending",  "verification": {    "type": "TXT",    "host": "_synq-verification.acme.com",    "value": "synq-verification=k7q2m5x9a3b4c6d8e2f7g5h3j9k4m2n6"  },  "problem": "record_not_found",  "verified_at": "2026-10-21T12:00:00.000Z",  "failing_until": "2026-10-21T12:00:00.000Z",  "last_checked_at": "2026-10-21T12:00:00.000Z",  "created_at": "2026-10-21T12:00:00.000Z"}