Logo
Akamai APIs API Documentation

Submit a bulk proxy zone delete request

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

Submits a request to delete one or more proxy zones asynchronously. Each element in the response array is the name of a proxy 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 proxy zone. It also checks that the proxy zone isn't currently delegated to Akamai's name servers. An offline task deletes the proxy 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/proxies/:proxyId/zones/delete-requests?bypassSafetyChecks=&accountSwitchKey=' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"comment":"Removing rivers and streams.","proxyZones":["river.com","stream.com"]}'

ENDPOINTS