CustomDomain™ docs
API referenceApplications

Point this application's customer domains at your own infrastructure

PUT
/applications/{id}/connect-target

Available on every plan (it is how a Connect-only plan gets domains that serve). cname_target must be a public hostname that is not the platform edge; send "" to go back to the edge. apex_ipv4 (up to 4 public IPv4 addresses) is what root domains get on DNS providers with no ALIAS-style record; without it such roots cannot be pointed at a hostname and POST /domains:check reports apex_strategy: unsupported. Existing connections pick up the new target for any record set that has not been written yet.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X PUT "https://example.com/applications/string/connect-target" \  -H "Content-Type: application/json" \  -d '{    "cname_target": "string"  }'
{  "application_id": "string",  "mode": "edge",  "connect_target": {    "cname_target": "string",    "apex_ipv4": [      "string"    ]  },  "edge": {    "cname_target": "string",    "apex_ipv4": [      "string"    ]  }}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}
{  "code": "string",  "title": "string",  "details": "string"}