For AI agents: the docs index is at https://techdocs.akamai.com/edge-dns/llms.txt. The index for every project on this site is at https://techdocs.akamai.com/llms.txt. Append .md to any documentation page URL to get its markdown version.

Jump to Content

Guide Recipes API Release notes CLI Terraform Control Center

API

Guide Recipes API Release notes CLI Terraform Control Center

API

Edge DNS API v2
API summary
OpenAPI schema
Get started
Use pagination
Group IDs and access level
Supported DNS resource record types
Use change lists
Example: Create a new primary zone
Zone create failure states
Subzone grants
Definitions of the activationState
Edge DNS API Troubleshooting
Errors
- 304
- 400
- 401
- 403
- 404
- 405
- 409
- 415
- 429
- 503

Zones

Zones
DNSSEC status
- Get a zone's DNSSEC statuspost
DNSSEC keys
- Get a zone's DNSSEC DNSKEY recordsget
- Get matching DS record key tagsget
Zone transfer status
- Get secondary zones transfer statuspost
Zone contracts
- Get a zone's contractget
Zone delegation
- Summarize delegation warningspost
- List a zone's delegation issuesget

Zone versions

Versions
Zone file
- Get a version's master zone fileget

Change lists

Change lists
Types
- List record set types for name and change listget
- Get a record set for a change listget
Record sets
Change list settings
- Get change list settingsget
- Update change list settingsput

Data services

Authorities
- List authoritative name serversget
Contracts
- List contractsget
DNSSEC algorithms
- List DNSSEC algorithmsget
Edge hostnames
- List edge hostnamesget
Groups
- List groupsget
TSIG key algorithms
- List TSIG key algorithmsget
Record types
- List record typesget

Bulk zones

Create requests
Convert requests
Delete requests

TSIG keys

TSIG keys

Shield NS53

DNS proxies
Proxy zones
Proxy zones filter mode conversion
DNS proxy health check
- Run existing proxy health checkpost
- Run proposed proxy health check for origin name serverspost
Create requests
Delete requests

Record sets

Names
- List record set names for a zoneget
Types
- List record set types for name and zoneget
Record sets
Master zone file
- Upload a master zone filepost
- Get a master zone fileget

API
Errors

401

API authentication error

See Get started for guidance on how to correctly set up your API hostname token.

Updated 8 months ago

Did this page help you?

Updated 8 months ago

Did this page help you?

Legal & privacy Cookie settings Akamai Status

Community Training Control Center Cloud Manager

© 2026 Akamai Technologies

Akamai.com

Akamai support Compute support Share feedback

Log out

Try Akamai

Akamai.com

Contact us Akamai support Compute support Share feedback

Log out