# 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)

<Note>
See the [API reference](/api-reference/ratelimit/delete-ratelimit-override) for the full HTTP endpoint documentation.
</Note>

## Usage

```bash
unkey api ratelimit delete-override [flags]
```

## Flags

<ParamField body="--namespace" type="string" required>
The id or name of the namespace containing the override. Must be 1-512 characters.
</ParamField>

<ParamField body="--identifier" type="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-512 characters.

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

## 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

<CodeGroup>
```bash Delete a specific override
unkey api ratelimit delete-override --namespace=api.requests --identifier=premium_user_123
```
```bash Delete a wildcard pattern override
unkey api ratelimit delete-override --namespace=api.requests --identifier="premium_*"
```
```bash JSON output for scripting
unkey api ratelimit delete-override --namespace=api.requests --identifier=premium_user_123 --output=json
```
</CodeGroup>

## Output

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

```text
req_2cGKbMxRyIzhCxo1Idjz8q

{}
```

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

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