Aula is in early access. These docs grow as it does.
Skip to Content
Aula
API ReferenceDomain

Verify the custom domain

Checks the DNS records now. Checks are spaced out: inside the interval the answer is the domain as it stands. Needs a `domain:write` token.

POST
/api/v1/domain/verify

Checks the DNS records now. Checks are spaced out: inside the interval the answer is the domain as it stands. Needs a domain:write token.

Authorization

bearerAuth
headerAuthorizationBearer <token>

Response Body

The domain after the check.

application/json
  1. response
id*string
Formatuuid
hostname*string
status*string
Value in"pending""active""misconfigured""failed""removed"
pointsTo*

Where the hostname points: an A record at an apex, else a CNAME.

ownershipRecord*
verification*array<>
verifiedAt*|
Formatdate-time
Example Request
curl -X POST 'https://aula.sferarc.com/api/v1/domain/verify'
Example Response
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "hostname": "string",  "status": "pending",  "pointsTo": {    "type": "A",    "value": "string"  },  "ownershipRecord": {    "type": "TXT",    "name": "string",    "value": "string"  },  "verification": [    {      "type": "string",      "domain": "string",      "value": "string",      "reason": "string"    }  ],  "verifiedAt": "2019-08-24T14:15:22Z"}