--- updatedAt: 2026-08-28T06:27:20.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/edge-dns/llms.txt --- # Purge Zone records from Shield NS53's cache Purges the Shield NS53 cache for the specified proxy zone. This operation is subject to a per-zone cooldown period. If the cache was already cleared within the cooldown window, the API returns a `429` response. # 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}/clear-cache": { "post": { "description": "Purges the Shield NS53 cache for the specified proxy zone. This operation is subject to a per-zone cooldown period. If the cache was already cleared within the cooldown window, the API returns a `429` response.", "externalDocs": { "description": "See documentation for this operation in Akamai's Edge DNS API", "url": "https://techdocs.akamai.com/edge-dns/reference/post-proxy-zone-clear-cache" }, "operationId": "post-proxy-zone-clear-cache", "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": "Cache clear initiated successfully." }, "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](https://techdocs.akamai.com/edge-dns/reference/429). You've exceeded the operation's rate limit.", "x-akamai": { "file-path": "errors/429.yaml" } } }, "summary": "Purge Zone records from Shield NS53's cache", "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-clear-cache.yaml", "path-info": "/proxies/{proxyId}/zones/{name}/clear-cache" } } }, "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) * [Schedule an immediate proxy zone's transfer](https://techdocs.akamai.com/edge-dns/reference/put-proxy-zone-schedule-immediate-transfer.md)