UNunkeyed
ratelimit

Delete ratelimit override

Changed on

Permanently remove a rate limit override. Affected identifiers immediately revert to the namespace default.

Use this to remove temporary overrides, reset identifiers to standard limits, or clean up outdated rules.

Important: Deletion is immediate and permanent. The override cannot be recovered and must be recreated if needed again.

Permissions: Requires ratelimit.*.delete_override or ratelimit.<namespace_id>.delete_override

post/v2/ratelimit.deleteOverride

Request

  • Base URL
    https://api.unkey.com
  • URL
    https://api.unkey.com/v2/ratelimit.deleteOverride
  • Auth
    HTTP bearer

Request body

namespacestring required

The id or name of the namespace containing the override.

identifierstring required

The exact identifier pattern of the override to delete. This must match exactly as it was specified when creating the override.

Important notes:

  • This is case-sensitive and must match exactly
  • Include any wildcards (*) that were part of the original pattern
  • For example, if the override was created for 'premium_', you must use 'premium_' here, not a specific ID

After deletion, any identifiers previously affected by this override will immediately revert to using the default rate limit for the namespace.

Response

Override successfully deleted. Affected identifiers now use default limits.

dataV2RatelimitDeleteOverrideResponseData required

Empty response object. A successful response indicates the override was successfully deleted. The operation is immediate - as soon as this response is received, the override no longer exists and affected identifiers have reverted to using the default rate limit for the namespace. No other data is returned as part of the deletion operation.

Example response

{
  "meta": {
    "requestId": "req_123"
  }
}

Changes

  • 89f6a753ffaeRevision changes
    • info

      the request property's maxLength was increased from 255 to 512

    • info

      the request property's maxLength was increased from 255 to 512

  • 43ad1ce9a152Revision changes
    • info

      the endpoint scheme security bearer was added to the API

    • info

      the endpoint scheme security rootKey was removed from the API