Logo
Akamai APIs API Documentation

Submit a bulk zone delete request

POST https://{{host}}/config-dns/v2/zones/delete-requests

Submits a request to delete one or more new Zones asynchronously. The request body contains a JSON array. Each element in the array is the name of a zone to be deleted. Before deleting a zone from the Edge DNS system, the API makes sure Akamai servers aren't receiving DNS requests for that zone. It also checks that the zone isn't currently delegated to Akamai's name servers. An offline task deletes the new zones. The result of this operation is a requestId, which you can use to check the task's status and view its results once it completes.

 

Body PARAM

Key Datatype Required Description 
bypassSafetyChecks
string (Optional) If `true`, disables the delegation checks and deletes the zones as soon as possible. It's `false` by default.
accountSwitchKey
string (Optional) For customers who manage more than one account, this [runs the operation from another account](https://techdocs.akamai.com/developer/docs/manage-many-accounts-with-one-api-client). The Identity and Access Management API provides a [list of available account switch keys](https://techdocs.akamai.com/iam-api/reference/get-client-account-switch-keys).



HEADERS

Key Datatype Required Description 
Content-Type
string
Accept
string




RESPONSES

status Created

{ "expirationDate": "2021-01-03T12:00:00Z", "requestId": "e585a640-0849-4b87-8dd9-91afdaf8851c" }



Curl
curl -X POST 'https://undefined/config-dns/v2/zones/delete-requests?bypassSafetyChecks=&accountSwitchKey=' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"comment":"Removing rivers and streams.","zones":["river.com","stream.com"]}'

ENDPOINTS