delete-override

Remove a rate limit override using the Unkey CLI so the affected identifier reverts to the namespace default. Clean up custom rate limits.

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

Flag	Type	Description
--root-key	string	Override root key ($UNKEY_ROOT_KEY)
--api-url	string	Override API base URL (default: https://api.unkey.com)
--config	string	Path to config file (default: ~/.unkey/config.toml)
--output	string	Output format. Use json for raw JSON
--body	string	Send this JSON string as the request body. You cannot combine it with request-building flags.

Examples

Delete a specific override

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

Output

Default output shows the request ID, followed by the result:

req_2cGKbMxRyIzhCxo1Idjz8q

{}

With --output=json, the full response envelope is returned:

{
  "meta": {
    "requestId": "req_2cGKbMxRyIzhCxo1Idjz8q"
  },
  "data": {}
}