Skip to main content
GET
Domain DNS Records
Returns the records you create at the domain’s DNS provider: a CNAME that points the hostname at Vertra Cloud, plus the records that validate ownership and issue the HTTPS certificate. Each record carries its own status, so you can see which ones are already resolving. Calling this route also refreshes the domain’s status and ssl_status. Requires the apps:read scope when called with an API key.
string
required
The application ID.
string
required
The domain ID, from List Application Domains.
string
If the application belongs to a workspace, the workspace’s ID. Required for workspace members acting on an application they don’t own.

Response

APIApplicationDomainDnsRecord[]
The records to create.
Create every record exactly as returned, and remove any other A, AAAA or CNAME record with the same name first. A root domain (apex: true) needs a DNS provider that supports CNAME at the root. See the custom domains guide. When the domain is removed, delete these records at your DNS provider too, as explained in Remove Application Domain.

Error Responses

string
The error code indicating the reason for the failure. Possible values:
  • VALIDATION_ERROR: The path parameters failed validation (400). The response also carries message and path.
  • UNAUTHORIZED: The request is not authenticated (401).
  • USER_NOT_FOUND: The authenticated user could not be resolved (401).
  • ACCESS_DENIED: The user does not have permission to read the application (403).
  • API_KEY_SCOPE_DENIED: The API key does not have the apps:read scope (403).
  • APP_NOT_FOUND: The specified application does not exist (404).
  • DOMAIN_NOT_FOUND: The application has no domain with that ID (404).
  • CUSTOM_DOMAIN_RECORD_NOT_FOUND: The domain’s DNS records are not available (404). Retry in a few minutes; if it persists, remove the domain and add it again.
  • RATE_LIMIT_EXCEEDED: The route’s budget was reached (429).
  • INTERNAL_SERVER_ERROR: Unexpected failure (500).
This route has its own budget of 10 requests per minute. See Rate Limiting.