--- updatedAt: 2026-08-28T06:27:20.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/edge-dns/llms.txt --- # Schedule an immediate proxy zone's transfer Schedules an immediate zone transfer for the specified proxy zone, bypassing any pending transfer delays. # 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": "Shield NS53", "version": "v2" }, "openapi": "3.0.0", "paths": { "/proxies/{proxyId}/zones/{name}/schedule-immediate-transfer": { "put": { "description": "Schedules an immediate zone transfer for the specified proxy zone, bypassing any pending transfer delays.", "externalDocs": { "description": "See documentation for this operation in Akamai's Edge DNS API", "url": "https://techdocs.akamai.com/edge-dns/reference/put-proxy-zone-schedule-immediate-transfer" }, "operationId": "put-proxy-zone-schedule-immediate-transfer", "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" } } ], "responses": { "200": { "content": {}, "description": "Zone transfer scheduled successfully." }, "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 trigger a zone transfer for this proxy zone." }, "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. The specified proxy zone doesn't exist or isn'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. The specified zone is not a secondary zone." }, "429": { "content": { "application/problem+json": { "example": { "detail": "Rate limit exceeded for operation 'schedule-immediate-transfer'.", "instance": "https://problems.luna.akamaiapis.net/authoritative-dns/rateLimitExceeded/f804a623-444c-4e4f-a719-2190313b99d7", "problemId": "f804a623-444c-4e4f-a719-2190313b99d7", "status": 429, "title": "Rate Limit Exceeded", "type": "https://problems.luna.akamaiapis.net/authoritative-dns/rateLimitExceeded" }, "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": "Too Many Requests. The rate limit for immediate zone transfer requests has been exceeded." } }, "summary": "Schedule an immediate proxy zone's transfer", "tags": [ "Proxy zones" ] }, "parameters": [ { "description": "The proxy ID you're working with.", "in": "path", "name": "proxyId", "required": true, "schema": { "example": "e585a640-0849-4b87-8dd9-91afdaf8851c", "type": "string" }, "x-akamai": { "file-path": "parameters/proxy-id-path.yaml" } }, { "description": "The proxy zone name.", "in": "path", "name": "name", "required": true, "schema": { "example": "example.com", "type": "string" }, "x-akamai": { "file-path": "parameters/proxy-zone-name-path.yaml" } } ], "x-akamai": { "file-path": "paths/proxy-zone-schedule-transfer.yaml", "path-info": "/proxies/{proxyId}/zones/{name}/schedule-immediate-transfer" } } }, "servers": [ { "url": "https://{hostname}/config-dns/v2" } ], "tags": [ { "description": "Groups operations to manage proxy zones.", "name": "Proxy zones" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "06-dns-shield.yaml" }, "x-readme": { "explorer-enabled": false, "samples-languages": [ "curl", "python", "node" ] } } ``` # Sibling pages * [List proxy zones](https://techdocs.akamai.com/edge-dns/reference/get-proxy-zones.md) * [List proxy zone keys](https://techdocs.akamai.com/edge-dns/reference/get-proxy-zone-keys.md) * [Get a proxy zone by name](https://techdocs.akamai.com/edge-dns/reference/get-proxy-zones-name.md) * [Save the apex alias for a proxy zone](https://techdocs.akamai.com/edge-dns/reference/put-proxy-zone-apex-alias.md) * [Delete apex alias for a proxy zone](https://techdocs.akamai.com/edge-dns/reference/delete-proxy-zone-apex-alias.md) * [Get a proxy zone TSIG key by name](https://techdocs.akamai.com/edge-dns/reference/get-proxy-zones-name-key.md) * [Update a proxy zone TSIG key by name](https://techdocs.akamai.com/edge-dns/reference/put-proxy-zones-name-key.md) * [Delete a proxy zone TSIG key by name](https://techdocs.akamai.com/edge-dns/reference/delete-proxy-zones-name-key.md) * [List proxies for a TSIG key](https://techdocs.akamai.com/edge-dns/reference/get-proxies-key-used-by.md) * [Get a manual filter report](https://techdocs.akamai.com/edge-dns/reference/get-proxy-zone-manual-filter-report.md) * [Manage manual filter names](https://techdocs.akamai.com/edge-dns/reference/post-proxy-zone-manual-filter-names.md) * [Initialize manual filter names with a zone file](https://techdocs.akamai.com/edge-dns/reference/post-proxy-zone-manual-filter-names-file.md) * [Purge Zone records from Shield NS53's cache](https://techdocs.akamai.com/edge-dns/reference/post-proxy-zone-clear-cache.md)