CustomDomain™ docs
API referenceManaged DNS

Remove one record from the managed zone

DELETE
/connections/{id}/managed-dns/records/{record_id}

Removes a discovered, imported or manual record. A customdomain record is how CustomDomain™ serves the domain and is refused with 409; disconnecting the domain removes it. Once the zone is active, only an API key or an app-scoped widget token may remove records.

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
record_id*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X DELETE "https://example.com/connections/string/managed-dns/records/string"
{  "zone": "acme.com",  "status": "awaiting_delegation",  "nameservers": [    "string"  ],  "observed_nameservers": [    "string"  ],  "registrar": {    "name": "string",    "url": "string"  },  "records": [    {      "id": "mdr_1f3a9c0b7d2e5a4c6b8d",      "type": "A",      "name": "string",      "value": "string",      "ttl": 0,      "priority": 0,      "source": "discovered"    }  ],  "warnings": [    "string"  ],  "checked_at": "2019-08-24T14:15:22Z",  "activated_at": "2019-08-24T14:15:22Z"}
{  "code": "string",  "title": "string",  "details": "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"}