v2

latestOpenAPI 3.1.0MIT2026-07-26105151330.5 KB

Domains

Initiate Domain Claim

Start claiming a domain that is already in use by another workspace. Returns the DNS TXT record you must publish at _migma.<rootDomain> to prove ownership. Requires API key with domain:write.

post/v1/domains/claims

Headers

Idempotency-Keystring

Optional key (max 100 chars) for safe retries. Same key + same body within 24h replays the original response (same status and body); same key + a different body returns 409 IDEMPOTENCY_CONFLICT. Scoped per API key.

Request body

domainstring required

The domain you want to claim, e.g. 'acme.com' or 'send.acme.com'. The root apex is resolved automatically.

Response

Claim challenge returned. Publish the TXT record, then call /v1/domains/claims/{domain}/verify.

successboolean required

errorstring nullable