organisation
Ask for the check of a domain
/api/v1/organisation/domains/{domain_id}/verification
Ask for the check of a declared domain, once its TXT record is published. The domain is pending until it is verified.
key
Required scope: org:admin
Path parameters
-
domain_idinteger · requiredId of the domain.
Response
200
Domain
-
idintegerId of the domain.
-
domainstringThe domain name.
-
statusstringinactive: declared, its check not asked for yet.pending: check asked for.verified: checked; every account verified on the domain is then a root reader of the organisation. -
record_namestringName of the DNS TXT record to publish.
-
record_valuestringValue of the DNS TXT record to publish.
Errors
-
401
No valid credential.
-
403
The credential lacks the required scope, or the account may not do this.
-
404
Nothing with that id, or nothing the account may open.
-
409
The current state of the content forbids the request.
-
422
A value is missing or malformed.
-
429
Too many requests;
Retry-Aftergives the seconds to wait.