POST /domains/claim
Claim a domain already registered by another account (DNS proof): returns the TXT record to publish; no information about the holder
API key (Bearer), on the public API endpoint.
Request body
application/json
| Field | Type | Description |
|---|---|---|
domain | string · required |
Responses
| Status | Description | Body |
|---|---|---|
201 | Claim created | DomainClaim |
200 | A claim already open for this domain, returned | DomainClaim |
401 | Key missing or invalid | Error |
403 | api_key_permission_insufficient (full_access key required) | |
404 | not_found (claim not served: Galon signature disabled), project_not_found | |
409 | domain_not_claimed (domain free: add it), domain_already_in_your_account, claim_conflict | |
422 | claim_body_invalid, domain_name_invalid | |
429 | claim_limit_reached (5 per project per day) | |
503 | mail_domain_claims_unavailable |
Examples
curl
curl -X POST "$GALON_API_BASE/domains/claim" \
-H "Authorization: Bearer $GALON_API_KEY" \
-H "Content-Type: application/json" \
-d '{"domain": "string"}'