Set ratelimit override
Changed onCreate or update a custom rate limit for specific identifiers, bypassing the namespace default.
Use this to create premium tiers with higher limits, apply stricter limits to specific users, or implement emergency throttling.
Important: Overrides take effect immediately and completely replace the default limit for matching identifiers. Use wildcard patterns (e.g., premium_*) to match multiple identifiers.
Permissions: Requires ratelimit.*.set_override or ratelimit.<namespace_id>.set_override
Request
- Base URLhttps://api.unkey.com
- URLhttps://api.unkey.com/v2/ratelimit.setOverride
- AuthHTTP bearer
Request body
Response
Override successfully created or updated and is now active.
Example response
{
"meta": {
"requestId": "req_123"
}
}Changes
- info
the
request property's maxLength was increased from255to512 - info
the
request property's maxLength was increased from255to512
- info
- info
the endpoint scheme security
bearerwas added to the API - info
the endpoint scheme security
rootKeywas removed from the API
- info