Skip to main content
err:unkey:data:ratelimit_override_not_found
Example
{
  "meta": {
    "requestId": "req_2c9a0jf23l4k567"
  },
  "error": {
    "detail": "This override does not exist.",
    "status": 404,
    "title": "Not Found",
    "type": "https://unkey.com/docs/errors/unkey/data/ratelimit_override_not_found"
  }
}

​
What Happened?

This error occurs when you’re trying to perform an operation on a rate limit override that doesn’t exist in the Unkey system, or when your key lacks the permission to read it. Rate limit overrides are used to create custom rate limits for specific identifiers within a namespace. Unkey deliberately returns this same 404 whether the override is missing or your key is not allowed to read it, so that responses never reveal whether an override exists to callers without read access. If you are certain the override exists, treat this error as a permission problem. Common scenarios that trigger this error:
  • Using an incorrect override ID
  • Referencing an override that has been deleted
  • Trying to get or modify an override for an identifier that doesn’t have one
  • Using the wrong namespace when looking up an override
  • Using a root key that lacks the ratelimit.*.read_override permission for this namespace or override
Here’s an example of a request that would trigger this error: 
# Attempting to get a non-existent rate limit override
curl -X POST https://api.unkey.com/v2/ratelimit.getOverride \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer unkey_YOUR_API_KEY" \
  -d '{
    "namespaceId": "ns_123abc",
    "identifier": "user_without_override"
  }'

​
How To Fix

Verify that you’re using the correct namespace and identifier, that the override still exists, and that your key may read it:
  1. Check the namespace ID and identifier in your request for typos
  2. List all overrides in the namespace to confirm if the one you’re looking for exists
  3. If the override has been deleted or never existed, you may need to create it
  4. If the override exists, check in the dashboard that your root key has the read_override permission for the namespace
Here’s how to list overrides in a namespace: 
curl -X POST https://api.unkey.com/v2/ratelimit.listOverrides \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer unkey_YOUR_API_KEY" \
  -d '{
    "namespaceId": "ns_123abc"
  }'
If you need to create a new override, use the ratelimit.setOverride endpoint: 
curl -X POST https://api.unkey.com/v2/ratelimit.setOverride \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer unkey_YOUR_API_KEY" \
  -d '{
    "namespaceId": "ns_123abc",
    "identifier": "user_123",
    "limit": 200,
    "duration": 60000
  }'

​
Common Mistakes

  • Wrong identifier: Using an incorrect user identifier when looking up overrides
  • Deleted overrides: Attempting to reference overrides that have been removed
  • Namespace mismatch: Looking in the wrong namespace for an override
  • Assuming defaults are overrides: Trying to get an override for an identifier that’s using default limits
  • Missing read permission: Debugging this as a data issue when the override exists but the root key lacks read_override for it
Last modified on June 19, 2026