Edge DNS API

Welcome to ​Akamai​ Edge DNS service. Edge DNS integrates easily with your existing DNS infrastructure to provide a secure, high performance, highly available and scalable solution for DNS hosting. As part of this service, Akamai runs name servers in multiple networks and in many geographic locations that are capable of resolving queries for your zones. ​Akamai​ IP Anycast technology is also capable of providing an unprecedented level of reliability and performance for name resolution.

The Edge DNS service supports three types of zones:

  • Primary: ​Akamai​ serves the DNS records of your zones without the need for master DNS servers maintained by you.
  • Secondary: ​Akamai​ serves the DNS records of your zones obtained by performing secured zone transfers from your master name server.
  • Alias: ​Akamai​ automatically mirrors the configuration of another Edge DNS zone, serving the same DNS records on both the alias zone and the target zone. For example, if you have registered a misspelled domain such as examlpe.com and you want it to have the same DNS records as example.com.

Unlike the v1 API, this API allows you to manage the configuration of all of your Edge DNS zones as well as the record sets of your Primary zones.

API summary

See the API's various operations for details on their request parameters and response data.

OperationMethodEndpoint
Zones
List zonesGET/zones
Create a zonePOST/zones
Get zones DNSSEC statusGET/zones/dns-sec-status
Get secondary zones transfer statusPOST/zones/zone-transfer-status
Get zone's settingsGET/zones/{zone}
Update zone's settingsPUT/zones/{zone}
Get zone's aliasesGET/zones/{zone}/aliases
Get zone's contractGET/zones/{zone}/contract
Record Sets
Get record set names for zoneGET/zones/{zone}/names
Get record set types for name and zoneGET/zones/{zone}/names/{name}/types
Delete a record setDELETE/zones/{zone}/names/{name}/types/{type}
Get a record setGET/zones/{zone}/names/{name}/types/{type}
Create a record setPOST/zones/{zone}/names/{name}/types/{type}
Replace a record setPUT/zones/{zone}/names/{name}/types/{type}
Get zone's record setsGET/zones/{zone}/recordsets
Create multiple record setsPOST/zones/{zone}/recordsets
Replace a record setPUT/zones/{zone}/recordsets
Get master zone fileGET/zones/{zone}/zone-file
Post master zone filePOST/zones/{zone}/zone-file
TSIG Keys
List TSIG keysGET/keys
Update TSIG key for multiple zonesPOST/keys/bulk-update
List zones using TSIG keyPOST/keys/used-by
Delete zone's TSIG keyDELETE/zones/{zone}/key
Get zone's TSIG keyGET/zones/{zone}/key
Update zone's TSIG keyPUT/zones/{zone}/key
List users of zone's TSIG keyGET/zones/{zone}/key/used-by
Bulk Zone Operations
Submit bulk-create requestPOST/zones/create-requests
Check bulk-create statusGET/zones/create-requests/{requestId}
Get bulk-create resultGET/zones/create-requests/{requestId}/result
Submit bulk-delete requestPOST/zones/delete-requests
Check bulk-delete statusGET/zones/delete-requests/{requestId}
Get bulk-delete resultGET/zones/delete-requests/{requestId}/result
Change Lists
List user's change listsGET/changelists
Create a change listPOST/changelists
Search for change listsPOST/changelists/search
Delete change listDELETE/changelists/{zone}
Get change listGET/changelists/{zone}
Show changesGET/changelists/{zone}/diff
Get record set names for change listGET/changelists/{zone}/names
Get record set types for name and change listGET/changelists/{zone}/names/{name}/types
Get a record set for change listGET/changelists/{zone}/names/{name}/types/{type}
Get record sets for change listGET/changelists/{zone}/recordsets
Upload master zone File to change listPOST/changelists/{zone}/recordsets
Modify record set for change listPOST/changelists/{zone}/recordsets/add-change
Get change list settingsGET/changelists/{zone}/settings
Update change list settingsPUT/changelists/{zone}/settings
Submit change listPOST/changelists/{zone}/submit
Zone Versions
List zone's versionsGET/zones/{zone}/versions
Show differencesGET/zones/{zone}/versions/diff
Get zone versionGET/zones/{zone}/versions/{uuid}
Get version's record setsGET/zones/{zone}/versions/{uuid}/recordsets
Reactivate versionPOST/zones/{zone}/versions/{uuid}/recordsets/activate
Get version's master zone fileGET/zones/{zone}/versions/{uuid}/zone-file
Data Services
List authoritative nameserversGET/data/authorities
List contractsGET/data/contracts
List DNSSEC algorithmsGET/data/dns-sec-algorithms
List edge hostnamesGET/data/edgehostnames
List groupsGET/data/groups
List record typesGET/data/recordset-types
List TSIG key algorithmsGET/data/tsig-algorithms