List an org's verified domains
The domains the org proved it owns, or is proving, with the TXT record each needs. Needs `org.sso.view` across the org, on any plan.
/v1/orgs/{org}/domainsThe domains the org proved it owns, or is proving, with the TXT record each needs. Needs org.sso.view across the org, on any plan.
Authorization
bearer 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
The org's id
^org_[0-9a-hjkmnp-tv-z]{26}$Query Parameters
At most this many items, 200 at the most.
1 <= value <= 20050The previous page's next_cursor, for the page after it.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/domains" \ -H "Authorization: Bearer $SYNQ_API_KEY"{ "data": [ { "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" } ], "next_cursor": "string"}Read a verified domain GET
Its status, its TXT record and what Synq saw at the last check. Needs `org.sso.view` across the org, on any plan.
Verify a domain now POST
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.