Logo
Akamai APIs API Documentation

Create a change list

POST https://{{host}}/config-dns/v2/changelists?zone={{zone}}

Creates a new change list based on the most recent version of a zone. No POST body is needed, since the object is read-only.

 

Body PARAM

Key Datatype Required Description 
zone
string (Required) The name of an Edge DNS zone.
overwrite
string (Optional) __Enum__ You can't create a change list if you've already created one for this zone. The default `none` raises an error if a change list exists. Use `any` to delete any existing change lists before running the create operation. Use `stale` to automatically delete stale change lists before running the create operation. The `stale` option raises an error if there's a change list attached to the current version.
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 
Accept
string




RESPONSES

status Created

{ "changeTag": "476754f4-d605-479f-853b-db854d7254fa", "lastModifiedDate": "2021-02-01T12:00:12.524Z", "stale": false, "zone": "example.com", "zoneVersionId": "1d9c887c-49bb-4382-87a6-d1bf690aa58f" }



Curl
curl -X POST 'https://undefined/config-dns/v2/changelists?zone=?zone=&overwrite=&accountSwitchKey=' -H 'Accept: application/json'

ENDPOINTS