Rate Limit Overrides

Set custom limits for specific identifiers

Ratelimit overrides are a way to override the ratelimit for specific users or group using an identifier.

Configure your override

import { Override } from "@unkey/ratelimit"

const unkey = new Override({
  rootKey: process.env.UNKEY_ROOT_KEY,
})

Use it

async function handler(request) {

  const identifier = request.getUserId() // or ip or anything else you want

  try {
    const { meta, data } = await unkey.setOverride({
        identifier: identifier,
        limit: 10,
        duration: 60000,
        namespaceName: "email.outbound",
    })
    
    if (data.error){
      // handle the error here
      console.error(data.error.message);
      return;
    }
  } catch (err) {
    console.error(err);
    return;
  }
  
  // handle the request here
}

There are four main functions to interact with overrides:

• setOverride Sets an override for a ratelimit.
• getOverride Gets a ratelimit override.
• deleteOverride Deletes an override.
• listOverrides Lists all overrides for a namnespace.