--- updatedAt: 2026-03-01T18:57:29.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/edgekv/llms.txt --- # Delete namespace Delete a namespace and all of its contents. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's EdgeKV API", "url": "https://techdocs.akamai.com/edgekv/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Namespaces and data", "version": "v1" }, "openapi": "3.0.0", "paths": { "/networks/{network}/namespaces/{namespaceId}": { "delete": { "description": "Delete a namespace and all of its contents.", "externalDocs": { "description": "See documentation for this operation in Akamai's EdgeKV API", "url": "https://techdocs.akamai.com/edgekv/reference/delete-namespace" }, "operationId": "delete-namespace", "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": { "202": { "content": { "application/json": { "example": { "scheduledDeleteTime": "2024-07-18T14:48:33Z" }, "schema": { "additionalProperties": false, "description": "When a namespace should be deleted.", "properties": { "scheduledDeleteTime": { "description": "Specifies the time when a namespace will be deleted, in ISO 8601 format.", "format": "date-time", "type": "string" } }, "required": [ "scheduledDeleteTime" ], "type": "object", "x-akamai": { "file-path": "schemas/scheduled-delete.yaml" } } } }, "description": "Returns the scheduled time for a namespace delete.", "headers": { "Location": { "description": "A URL path to poll the remaining time before a namespace delete.", "example": "/edgekv/v1/networks/production/namespaces/nmsp/status/scheduled-delete", "schema": { "type": "string" } }, "Retry-After": { "description": "Number of seconds remaining before a namespace delete.", "example": "6213", "schema": { "type": "string" } } } }, "400": { "content": { "application/problem+json": { "example": { "additionalDetail": { "requestId": "5d424b9289ab9b43" }, "detail": "The requested namespace does not exist.", "errorCode": "EKV_9000", "instance": "/edgekv/error-instances/2c82be29-f909-4d42-b775-de404e264fd9", "status": 400, "title": "Bad Request", "type": "/edgekv/error-types/edgekv-bad-request" }, "schema": { "additionalProperties": true, "description": "Error messaging.", "properties": { "additionalDetail": { "additionalProperties": false, "description": "More details about the error.", "properties": { "requestId": { "description": "Request identifier.", "type": "string" } }, "type": "object" }, "detail": { "description": "A description of the error.", "type": "string" }, "errorCode": { "description": "Internal error code used to assist with troubleshooting by Akamai employees.", "type": "string" }, "instance": { "description": "Reference to unique instance of the error.", "type": "string" }, "status": { "description": "The HTTP code for the error.", "type": "integer" }, "title": { "description": "Text representation of the HTTP error code.", "type": "string" }, "type": { "description": "Reference to additional documentation.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/error.yaml" } } } }, "description": "[Bad request](https://techdocs.akamai.com/edgekv/reference/400). Namespace doesn't exist.", "x-akamai": { "file-path": "errors/400-namespace.yaml" } }, "500": { "content": { "application/problem+json": { "example": { "additionalDetail": { "requestId": "cd9b61e08148009b" }, "detail": "An internal error occurred.", "errorCode": "EKV_0000", "instance": "/edgekv/error-instances/cdb7767c-817e-4805-9f28-0816eefa0ba8", "status": 500, "title": "Internal Server Error", "type": "/edgekv/error-types/edgekv-internal-server-error" }, "schema": { "additionalProperties": true, "description": "Error messaging.", "properties": { "additionalDetail": { "additionalProperties": false, "description": "More details about the error.", "properties": { "requestId": { "description": "Request identifier.", "type": "string" } }, "type": "object" }, "detail": { "description": "A description of the error.", "type": "string" }, "errorCode": { "description": "Internal error code used to assist with troubleshooting by Akamai employees.", "type": "string" }, "instance": { "description": "Reference to unique instance of the error.", "type": "string" }, "status": { "description": "The HTTP code for the error.", "type": "integer" }, "title": { "description": "Text representation of the HTTP error code.", "type": "string" }, "type": { "description": "Reference to additional documentation.", "type": "string" } }, "type": "object", "x-akamai": { "file-path": "schemas/error.yaml" } } } }, "description": "[Internal server error](https://techdocs.akamai.com/edgekv/reference/500).", "x-akamai": { "file-path": "errors/500.yaml" } } }, "summary": "Delete namespace", "tags": [ "Namespaces" ] }, "parameters": [ { "description": "Unique identifier for each namespace.", "in": "path", "name": "namespaceId", "required": true, "schema": { "example": "marketing", "type": "string" }, "x-akamai": { "file-path": "parameters/namespace-id-path.yaml" } }, { "description": "__Enum__ Network environment to execute the API request on.", "in": "path", "name": "network", "required": true, "schema": { "enum": [ "production", "staging" ], "example": "staging", "type": "string" }, "x-akamai": { "file-path": "parameters/network-path.yaml" } } ], "x-akamai": { "file-path": "paths/namespace-network.yaml", "path-info": "/networks/{network}/namespaces/{namespaceId}" } } }, "servers": [ { "url": "https://{hostname}/edgekv/v1" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "04-networks.yaml" }, "x-readme": { "samples-languages": [ "curl", "python", "node" ] } } ``` # Sibling pages * [Create a namespace](https://techdocs.akamai.com/edgekv/reference/post-namespace.md) * [List namespaces](https://techdocs.akamai.com/edgekv/reference/get-namespaces.md) * [Get namespace details](https://techdocs.akamai.com/edgekv/reference/get-namespace.md) * [Update namespace details](https://techdocs.akamai.com/edgekv/reference/put-namespace.md) * [List groups within a namespace](https://techdocs.akamai.com/edgekv/reference/get-namespace-groups.md) * [Download namespace data](https://techdocs.akamai.com/edgekv/reference/get-namespace-download.md) * [Get namespace delete time](https://techdocs.akamai.com/edgekv/reference/get-scheduled-delete.md) * [Reschedule a namespace delete](https://techdocs.akamai.com/edgekv/reference/put-scheduled-delete.md) * [Download group data](https://techdocs.akamai.com/edgekv/reference/get-group-download.md) * [Cancel a scheduled namespace delete](https://techdocs.akamai.com/edgekv/reference/delete-scheduled-delete.md) * [Get namespace upload job details](https://techdocs.akamai.com/edgekv/reference/get-namespace-upload-job.md) * [Upload namespace data](https://techdocs.akamai.com/edgekv/reference/post-namespace-upload.md) * [List upload jobs](https://techdocs.akamai.com/edgekv/reference/get-namespace-upload.md)