Skip to main content
GET
/
v1
/
apps
/
{id}
/
network
/
dns
Custom Domain DNS Records
curl --request GET \
  --url https://api.vertracloud.app/v1/apps/{id}/network/dns
{
  "response": [
    {
      "type": "CNAME",
      "name": "example.com",
      "value": "cname.vertraweb.app",
      "status": "pending_validation"
    },
    {
      "type": "TXT",
      "name": "_acme-challenge.example.com",
      "value": "v111d4af8cd74272a284831fbae14a8v",
      "status": "pending_validation"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.vertracloud.app/llms.txt

Use this file to discover all available pages before exploring further.

​
id
string
required
The ID of the application to retrieve DNS records for.

​
Response

​
response
array
An array of DNS record objects required for the custom domain.
{
  "response": [
    {
      "type": "CNAME",
      "name": "example.com",
      "value": "cname.vertraweb.app",
      "status": "pending_validation"
    },
    {
      "type": "TXT",
      "name": "_acme-challenge.example.com",
      "value": "v111d4af8cd74272a284831fbae14a8v",
      "status": "pending_validation"
    }
  ]
}

​
Error Responses

​
code
string
The error code indicating the reason for failure. Possible values:
  • UNAUTHORIZED: The user is not authenticated or lacks sufficient permissions.
  • PLAN_RESTRICTED_FEATURE: The user’s plan does not support custom domains.
  • APP_NOT_FOUND: The specified application does not exist or does not belong to the user.
  • NO_CUSTOM_DOMAIN_SET: The application does not have a custom domain configured.
​
message
string
A descriptive message providing additional details about the error.
{
  "code": "UNAUTHORIZED"
}