Logo
Akamai APIs API Documentation

Search for change lists

POST https://{{host}}/config-dns/v2/changelists/search

Given a list of zone names, this operation lists the change lists that you've created on those zones. If the input list is empty, the response doesn't return any change lists. Note that it's possible to own a change list on a zone that you're no longer allowed to access.

 

Body PARAM

Key Datatype Required Description 
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 OK

{ "changeLists": [ { "changeTag": "476754f4-d605-479f-853b-db854d7254fa", "lastModifiedDate": "2021-02-01T12:00:12.524Z", "stale": false, "zone": "example.com", "zoneVersionId": "1d9c887c-49bb-4382-87a6-d1bf690aa58f" }, { "changeTag": "17bfec8f-2b95-4aec-9959-518998b8b3c6", "lastModifiedDate": "2021-04-21T19:04:00Z", "stale": true, "zone": "river.com", "zoneVersionId": "82ffbdd6-d328-4b8a-aa7c-bc9319c51bf3" } ] }



Curl
curl -X POST 'https://undefined/config-dns/v2/changelists/search?accountSwitchKey=' -H 'Content-Type: application/json' -H 'Accept: application/json' -d '{"zones":["river.com","brook.com"]}'

ENDPOINTS