CustomDomain Docs
ReferenceAPI referenceApplications

Where this application's customer domains point

Where this application's customer domains point: CustomDomain™ API reference in the applications group. Covers parameters, request body and responses.

GET
/applications/{id}/connect-target

mode: edge (the default) points customer domains at the platform edge, which proxies their traffic to your origin (Power, Growth plan and up, once a default origin is set; without one the edge answers 421). mode: custom points them at your own infrastructure: subdomains get a CNAME to cname_target; a root domain gets an ALIAS, ANAME or flattened CNAME to it on providers that have one, and A records to apex_ipv4 elsewhere. edge echoes what edge mode points at, so a console can show both options. A delegated agent token needs app:read.

AuthorizationBearer <token>

Long-lived tenant API key, cd_live_… (production) or cd_test_… (staging, development), stored hashed. Keys created before the switch to cd_ start with sk_live_… / sk_test_… and are still accepted. Scoped to the owning application's tenant.

In: header

Path Parameters

id*string

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/applications/string/connect-target"
{  "application_id": "string",  "mode": "edge",  "connect_target": {    "cname_target": "string",    "apex_ipv4": [      "string"    ]  },  "edge": {    "cname_target": "string",    "apex_ipv4": [      "string"    ]  },  "warnings": [    "string"  ],  "existing_domains": {    "moved": 0,    "kept": 0  }}
{  "code": "account_not_verifiable",  "title": "string",  "details": "string",  "challenge": {    "value": "string",    "bits": 1,    "expires_at": "2019-08-24T14:15:22Z"  }}
{  "code": "account_not_verifiable",  "title": "string",  "details": "string",  "challenge": {    "value": "string",    "bits": 1,    "expires_at": "2019-08-24T14:15:22Z"  }}
{  "code": "account_not_verifiable",  "title": "string",  "details": "string",  "challenge": {    "value": "string",    "bits": 1,    "expires_at": "2019-08-24T14:15:22Z"  }}