--- updatedAt: 2026-05-28T13:08:21.000Z agentTools: siteIndex: https://techdocs.akamai.com/llms.txt projectIndex: https://techdocs.akamai.com/application-security/llms.txt --- # Remove a rate policy __All products__ Delete the specified rate policy. You can't delete a rate policy that is actively in use. To delete the rate policy, first activate an older configuration version or create a new version without the policy in place. # OpenAPI definition ```json { "externalDocs": { "description": "See documentation for Akamai's Application Security API", "url": "https://techdocs.akamai.com/application-security/reference" }, "info": { "license": { "name": "Apache 2.0", "url": "https://www.apache.org/licenses/LICENSE-2.0.html" }, "title": "Configuration settings", "version": "v1" }, "openapi": "3.0.0", "paths": { "/configs/{configId}/versions/{versionNumber}/rate-policies/{ratePolicyId}": { "delete": { "description": "__All products__ Delete the specified rate policy. You can't delete a rate policy that is actively in use. To delete the rate policy, first activate an older configuration version or create a new version without the policy in place.", "externalDocs": { "description": "See documentation for this operation in Akamai's Application Security API", "url": "https://techdocs.akamai.com/application-security/reference/delete-rate-policy" }, "operationId": "delete-rate-policy", "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": { "204": { "content": {}, "description": "Successfully deleted the rate policy." }, "403": { "content": { "application/problem+json": { "example": { "detail": "You do not have the necessary access to perform this operation or the requested resource cannot be modified", "instance": "https://problems.luna.akamaiapis.net/appsec/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749", "status": 403, "title": "Forbidden", "type": "https://problems.luna.akamaiapis.net/appsec-resource/error-types/ACCESS-DENIED" }, "schema": { "additionalProperties": true, "description": "Details the errors you can receive.", "properties": { "detail": { "description": "The detailed error message.", "type": "string" }, "fieldErrors": { "description": "Pointers to fields for which invalid input was provided, whose values are messages detailing the reason this input was invalid for this field.", "type": "object" }, "instance": { "description": "The non-referenceable URI that indicates the error instance.", "example": "https://problems.luna.akamaiapis.net/api-definitions/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749", "type": "string" }, "status": { "description": "The HTTP status code.", "example": 404, "type": "integer" }, "title": { "description": "The error title.", "example": "Not Found", "type": "string" }, "type": { "description": "The URL for the error type.", "example": "https://problems.luna.akamaiapis.net/api-definitions/error-types/NOT-FOUND", "type": "string" } }, "required": [ "title", "type", "detail", "instance", "status" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-details.yaml" } } } }, "description": "[Forbidden](https://techdocs.akamai.com/application-security/reference/403). You don't have access to rate policy in this security configuration.", "x-akamai": { "file-path": "errors/403.yaml" } }, "404": { "content": { "application/problem+json": { "example": { "detail": "The requested resource is not found", "instance": "https://problems.luna.akamaiapis.net/appsec/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749", "status": 404, "title": "Not Found", "type": "https://problems.luna.akamaiapis.net/appsec/error-types/NOT-FOUND" }, "schema": { "additionalProperties": true, "description": "Details the errors you can receive.", "properties": { "detail": { "description": "The detailed error message.", "type": "string" }, "fieldErrors": { "description": "Pointers to fields for which invalid input was provided, whose values are messages detailing the reason this input was invalid for this field.", "type": "object" }, "instance": { "description": "The non-referenceable URI that indicates the error instance.", "example": "https://problems.luna.akamaiapis.net/api-definitions/error-instances/d54686b5-21cb-4ab7-a8d6-a92282cf1749", "type": "string" }, "status": { "description": "The HTTP status code.", "example": 404, "type": "integer" }, "title": { "description": "The error title.", "example": "Not Found", "type": "string" }, "type": { "description": "The URL for the error type.", "example": "https://problems.luna.akamaiapis.net/api-definitions/error-types/NOT-FOUND", "type": "string" } }, "required": [ "title", "type", "detail", "instance", "status" ], "type": "object", "x-akamai": { "file-path": "schemas/problem-details.yaml" } } } }, "description": "[Not found](https://techdocs.akamai.com/application-security/reference/404). Security configuration version or rate policy wasn't found.", "x-akamai": { "file-path": "errors/404.yaml" } } }, "summary": "Remove a rate policy", "tags": [ "Shared resources: Rate policies" ], "x-akamai": { "labels": [ "All products" ] } }, "parameters": [ { "description": "A unique identifier for each configuration.", "in": "path", "name": "configId", "required": true, "schema": { "example": 77653, "format": "int64", "type": "integer" }, "x-akamai": { "file-path": "parameters/config-id-path.yaml" } }, { "description": "A unique identifier for each version of a configuration.", "in": "path", "name": "versionNumber", "required": true, "schema": { "example": 25, "type": "integer" }, "x-akamai": { "file-path": "parameters/version-number-path.yaml" } }, { "description": "A unique identifier for each rate policy.", "in": "path", "name": "ratePolicyId", "required": true, "schema": { "example": 112231, "type": "integer" }, "x-akamai": { "file-path": "parameters/rate-policy-id-path.yaml" } } ], "x-akamai": { "file-path": "paths/config-rate-policy.yaml", "path-info": "/configs/{configId}/versions/{versionNumber}/rate-policies/{ratePolicyId}" } } }, "servers": [ { "url": "https://{hostname}/appsec/v1" } ], "tags": [ { "description": "Manage rate policies for security configurations.", "name": "Shared resources: Rate policies" } ], "x-akamai": { "auth-type": "EDGE_GRID", "file-path": "01-configuration.yaml" }, "x-readme": { "explorer-enabled": false, "samples-languages": [ "curl", "python", "node" ] } } ``` # Sibling pages * [Create a rate policy](https://techdocs.akamai.com/application-security/reference/post-rate-policies.md) * [List rate policies](https://techdocs.akamai.com/application-security/reference/get-rate-policies.md) * [Get a rate policy](https://techdocs.akamai.com/application-security/reference/get-rate-policy.md) * [Modify a rate policy](https://techdocs.akamai.com/application-security/reference/put-rate-policy.md) * [Modify a rate policy evaluation](https://techdocs.akamai.com/application-security/reference/put-rate-policy-evaluation.md)