---
title: "Reset a specific rate limit by its identifier."
method: POST
path: "/api/v1/rate-limit/reset/{identifier}"
---

# Reset a specific rate limit by its identifier.

`POST /api/v1/rate-limit/reset/{identifier}`

**Access**: Restricted to users with `role: "SUPERADMIN"`
**Purpose**: Clears rate limit counters for a specific user or IP address

**Path Parameters**:
- `identifier`: The rate limit identifier (e.g., "user:123", "ip:192.168.1.1",
  "auth:hash:ip")

**Success Response Schema**:
```json
{
  "message": "Rate limit reset for identifier: user:123"
}
```

**Use Cases**:
- Clear rate limit for specific user who was legitimately rate limited
- Remove rate limit for specific IP address
- Targeted rate limit management without affecting all users

**Error Responses**:
- `403 Forbidden`: User does not have SUPERADMIN privileges
- `401 Unauthorized`: Valid JWT token required
- `404 Not Found`: No rate limit found for the specified identifier
- `500 Internal Server Error`: Failed to reset rate limit

## Path parameters

- `identifier` string, required

## Request body

- object

## Response `200`

Success

- object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/trends/apis/trends-earth-api.md) · [All operations](https://skmtc.dev/trends/apis/trends-earth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/trends/trends-earth-api/revisions/6bdbc0b84666/schema)