--- updatedAt: 2026-05-27T18:13:35.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/edge-dns/llms.txt --- # Bulk edit secondary zones Updates settings for one or more secondary zones in a single operation. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Edge DNS API", "url": "https://techdocs.akamai.com/edge-dns/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Zones", "version": "v2" }, "openapi": "3.0.0", "paths": { "/zones/edit-secondary-zones": { "post": { "description": "Updates settings for one or more secondary zones in a single operation.", "externalDocs": { "description": "See documentation for this operation in Akamai's Edge DNS API", "url": "https://techdocs.akamai.com/edge-dns/reference/post-zones-edit-secondary-zones" }, "operationId": "post-zones-edit-secondary-zones", "parameters": [ { "description": "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).", "in": "query", "name": "accountSwitchKey", "required": false, "schema": { "example": "1-5C0YLB:1-8BYUX", "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "settings": { "comment": "Updating secondary zone masters", "masters": [ "192.0.2.183", "192.0.2.40" ] }, "zones": [ { "versionId": "e89b10b0-a847-11e9-a2a3-2a2ae2dbcce4", "zone": "example.com" } ] }, "schema": { "additionalProperties": false, "properties": { "settings": { "additionalProperties": false, "description": "Secondary zone settings to apply to all listed zones.", "properties": { "comment": { "description": "Free-form comment about the change.", "type": "string" }, "masters": { "description": "List of primary name server IP addresses for zone transfer.", "items": { "type": "string" }, "type": "array" } }, "type": "object" }, "zones": { "description": "List of secondary zones to edit, each identified by name and current version ID.", "items": { "additionalProperties": false, "properties": { "versionId": { "description": "The current `ETag` version identifier for the zone.", "type": "string" }, "zone": { "description": "The zone name.", "type": "string" } }, "required": [ "zone", "versionId" ], "type": "object" }, "type": "array" } }, "required": [ "zones", "settings" ], "type": "object", "x-akamai": { "file-path": "schemas/bulk-secondary-zone-edit-request.yaml" } } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "example": { "zones": [ { "versionId": "f7da1c90-b958-11e9-b3b4-3b3bf3ecdd5e", "zone": "example.com" } ] }, "schema": { "additionalProperties": false, "properties": { "zones": { "description": "List of zones successfully updated, each with its new version ID.", "items": { "additionalProperties": false, "properties": { "versionId": { "description": "The new `ETag` version identifier for the zone after the update.", "type": "string" }, "zone": { "description": "The zone name.", "type": "string" } }, "required": [ "zone", "versionId" ], "type": "object" }, "type": "array" } }, "required": [ "zones" ], "type": "object", "x-akamai": { "file-path": "schemas/bulk-secondary-zone-edit-response.yaml" } } } }, "description": "Successful response." }, "400": { "content": { "application/problem+json": { "example": { "detail": "Invalid value for parameter 'sortBy': 'foo'. Valid values are: name, type.", "instance": "https://problems.luna.akamaiapis.net/authoritative-dns/illegalValue/f804a623-444c-4e4f-a719-2190313b99d7", "problemId": "f804a623-444c-4e4f-a719-2190313b99d7", "status": 400, "title": "Illegal Value", "type": "https://problems.luna.akamaiapis.net/authoritative-dns/illegalValue" }, "schema": { "additionalProperties": true, "description": "An RFC 7807 problem details object returned when an error occurs.", "properties": { "detail": { "description": "A human-readable explanation of the error.", "type": "string" }, "instance": { "description": "A URI that identifies this specific error occurrence.", "type": "string" }, "problemId": { "description": "A unique identifier for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code for this error.", "type": "integer" }, "title": { "description": "A short, human-readable summary of the error.", "type": "string" }, "type": { "description": "A non-navigable URI that uniquely identifies the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "Bad Request. The request body is missing zone data or contains an invalid field value." }, "401": { "content": { "application/problem+json": { "example": { "detail": "not logged in", "instance": "https://problems.luna.akamaiapis.net/authoritative-dns/notLoggedIn/f804a623-444c-4e4f-a719-2190313b99d7", "problemId": "f804a623-444c-4e4f-a719-2190313b99d7", "status": 401, "title": "Not Logged In", "type": "https://problems.luna.akamaiapis.net/authoritative-dns/notLoggedIn" }, "schema": { "additionalProperties": true, "description": "An RFC 7807 problem details object returned when an error occurs.", "properties": { "detail": { "description": "A human-readable explanation of the error.", "type": "string" }, "instance": { "description": "A URI that identifies this specific error occurrence.", "type": "string" }, "problemId": { "description": "A unique identifier for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code for this error.", "type": "integer" }, "title": { "description": "A short, human-readable summary of the error.", "type": "string" }, "type": { "description": "A non-navigable URI that uniquely identifies the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "Unauthorized. Your credentials are missing or invalid." }, "403": { "content": { "application/problem+json": { "example": { "detail": "Access denied for contract C-0N7RAC7.", "instance": "https://problems.luna.akamaiapis.net/authoritative-dns/forbidden/f804a623-444c-4e4f-a719-2190313b99d7", "problemId": "f804a623-444c-4e4f-a719-2190313b99d7", "status": 403, "title": "Forbidden", "type": "https://problems.luna.akamaiapis.net/authoritative-dns/forbidden" }, "schema": { "additionalProperties": true, "description": "An RFC 7807 problem details object returned when an error occurs.", "properties": { "detail": { "description": "A human-readable explanation of the error.", "type": "string" }, "instance": { "description": "A URI that identifies this specific error occurrence.", "type": "string" }, "problemId": { "description": "A unique identifier for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code for this error.", "type": "integer" }, "title": { "description": "A short, human-readable summary of the error.", "type": "string" }, "type": { "description": "A non-navigable URI that uniquely identifies the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "Forbidden. You don't have permission to update one or more of the specified zones." }, "404": { "content": { "application/problem+json": { "example": { "detail": "Zone not found: example.com.", "instance": "https://problems.luna.akamaiapis.net/authoritative-dns/notFound/f804a623-444c-4e4f-a719-2190313b99d7", "problemId": "f804a623-444c-4e4f-a719-2190313b99d7", "status": 404, "title": "Not Found", "type": "https://problems.luna.akamaiapis.net/authoritative-dns/notFound" }, "schema": { "additionalProperties": true, "description": "An RFC 7807 problem details object returned when an error occurs.", "properties": { "detail": { "description": "A human-readable explanation of the error.", "type": "string" }, "instance": { "description": "A URI that identifies this specific error occurrence.", "type": "string" }, "problemId": { "description": "A unique identifier for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code for this error.", "type": "integer" }, "title": { "description": "A short, human-readable summary of the error.", "type": "string" }, "type": { "description": "A non-navigable URI that uniquely identifies the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "Not Found. One or more specified zones don't exist or aren't accessible." }, "409": { "content": { "application/problem+json": { "example": { "detail": "Zone already exists: example.com.", "instance": "https://problems.luna.akamaiapis.net/authoritative-dns/zoneNameConflict/f804a623-444c-4e4f-a719-2190313b99d7", "problemId": "f804a623-444c-4e4f-a719-2190313b99d7", "status": 409, "title": "Zone Name Conflict", "type": "https://problems.luna.akamaiapis.net/authoritative-dns/zoneNameConflict" }, "schema": { "additionalProperties": true, "description": "An RFC 7807 problem details object returned when an error occurs.", "properties": { "detail": { "description": "A human-readable explanation of the error.", "type": "string" }, "instance": { "description": "A URI that identifies this specific error occurrence.", "type": "string" }, "problemId": { "description": "A unique identifier for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code for this error.", "type": "integer" }, "title": { "description": "A short, human-readable summary of the error.", "type": "string" }, "type": { "description": "A non-navigable URI that uniquely identifies the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "Conflict. One or more zones can't be updated because their current type or state doesn't allow this operation." }, "415": { "content": { "application/problem+json": { "example": { "detail": "Content type 'text/plain' not supported.", "instance": "https://problems.luna.akamaiapis.net/authoritative-dns/unsupportedMediaType/f804a623-444c-4e4f-a719-2190313b99d7", "problemId": "f804a623-444c-4e4f-a719-2190313b99d7", "status": 415, "title": "Unsupported Media Type", "type": "https://problems.luna.akamaiapis.net/authoritative-dns/unsupportedMediaType" }, "schema": { "additionalProperties": true, "description": "An RFC 7807 problem details object returned when an error occurs.", "properties": { "detail": { "description": "A human-readable explanation of the error.", "type": "string" }, "instance": { "description": "A URI that identifies this specific error occurrence.", "type": "string" }, "problemId": { "description": "A unique identifier for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code for this error.", "type": "integer" }, "title": { "description": "A short, human-readable summary of the error.", "type": "string" }, "type": { "description": "A non-navigable URI that uniquely identifies the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "Unsupported Media Type. The request's `Content-Type` header is not supported. Use `application/json`." }, "422": { "content": { "application/problem+json": { "example": { "detail": "Invalid value for field 'ttl': must be between 0 and 2147483647.", "instance": "https://problems.luna.akamaiapis.net/authoritative-dns/illegalBodyValue/f804a623-444c-4e4f-a719-2190313b99d7", "problemId": "f804a623-444c-4e4f-a719-2190313b99d7", "status": 422, "title": "Illegal Body Value", "type": "https://problems.luna.akamaiapis.net/authoritative-dns/illegalBodyValue" }, "schema": { "additionalProperties": true, "description": "An RFC 7807 problem details object returned when an error occurs.", "properties": { "detail": { "description": "A human-readable explanation of the error.", "type": "string" }, "instance": { "description": "A URI that identifies this specific error occurrence.", "type": "string" }, "problemId": { "description": "A unique identifier for this error occurrence.", "type": "string" }, "status": { "description": "The HTTP status code for this error.", "type": "integer" }, "title": { "description": "A short, human-readable summary of the error.", "type": "string" }, "type": { "description": "A non-navigable URI that uniquely identifies the error type.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/problem.yaml" } } } }, "description": "Unprocessable Entity. The request body contains a semantically invalid field value." } }, "summary": "Bulk edit secondary zones", "tags": [ "Zones" ] }, "x-akamai": { "file-path": "paths/edit-secondary-zones.yaml", "path-info": "/zones/edit-secondary-zones" } } }, "servers": [ { "url": "https://{hostname}/config-dns/v2" } ], "tags": [ { "description": "Groups operations to manage zones.", "name": "Zones" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "01-zones.yaml" }, "x-readme": { "explorer-enabled": false, "samples-languages": [ "curl", "python", "node" ] } } ``` # Sibling pages * [Create a zone](https://techdocs.akamai.com/edge-dns/reference/post-zone.md) * [List zones](https://techdocs.akamai.com/edge-dns/reference/get-zones.md) * [Get zone propagation status](https://techdocs.akamai.com/edge-dns/reference/post-zones-propagation-status.md) * [Get a zone's settings](https://techdocs.akamai.com/edge-dns/reference/get-zone.md) * [Update a zone's settings](https://techdocs.akamai.com/edge-dns/reference/put-zone.md) * [Get a zone's aliases](https://techdocs.akamai.com/edge-dns/reference/get-zone-aliases.md) * [Schedule an immediate zone transfer](https://techdocs.akamai.com/edge-dns/reference/put-zones-zone-schedule-immediate-transfer.md)