Skip to main content
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. Required permissions:
  • ratelimit.*.delete_override (workspace-wide)
  • ratelimit.<namespace_id>.delete_override (scoped to a specific namespace)
See the API reference for the full HTTP endpoint documentation.

​
Usage

unkey api ratelimit delete-override [flags]

​
Flags

​
--namespace
string
required
The id or name of the namespace containing the override. Must be 1-255 characters.
​
--identifier
string
required
The exact identifier pattern of the override to delete. This must match exactly as it was specified when creating the override, including any wildcards (*) that were part of the original pattern. Case-sensitive. Must be 1-255 characters.After deletion, any identifiers previously affected by this override will immediately revert to using the default rate limit for the namespace.

​
Global Flags

FlagTypeDescription
--root-keystringOverride root key ($UNKEY_ROOT_KEY)
--api-urlstringOverride API base URL (default: https://api.unkey.com)
--configstringPath to config file (default: ~/.unkey/config.toml)
--outputstringOutput format — use json for raw JSON

​
Examples

unkey api ratelimit delete-override --namespace=api.requests --identifier=premium_user_123

​
Output

Default output shows the request ID with latency, followed by the result: 
req_2cGKbMxRyIzhCxo1Idjz8q (took 45ms)

{}
With --output=json, the full response envelope is returned: 
{
  "meta": {
    "requestId": "req_2cGKbMxRyIzhCxo1Idjz8q"
  },
  "data": {}
}
Last modified on March 26, 2026