> ## Documentation Index
> Fetch the complete documentation index at: https://unkey.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Set Override

> Create or update a rate limit override for a specific identifier using the @unkey/ratelimit SDK. Bypass namespace defaults per user or key.

## Request

<ParamField body="identifier" type="string" required>
  Identifier of your user, this can be their userId, an email, an ip or anything
  else. Wildcards ( \* ) can be used to match multiple identifiers. More info can
  be found at [https://www.unkey.com/docs/ratelimiting/overrides#wildcard-rules](https://www.unkey.com/docs/ratelimiting/overrides#wildcard-rules)
</ParamField>

<ParamField body="limit" type="number" required>
  How many requests may pass in a given window.
</ParamField>

<ParamField body="duration" type="number" required>
  The window duration in milliseconds.
</ParamField>

<Warning>
  Either `namespaceId` or `namespaceName` is required. Not both.
</Warning>

<ParamField body="namespaceId" type="string">
  The id of the namespace. Either namespaceId or namespaceName must be provided
</ParamField>

<ParamField body="namespaceName" type="string">
  Namespaces group different limits together for better analytics. You might
  have a namespace for your public API and one for internal tRPC routes.
  Wildcards can also be used, more info can be found at
  [https://www.unkey.com/docs/ratelimiting/overrides#wildcard-rules](https://www.unkey.com/docs/ratelimiting/overrides#wildcard-rules)
</ParamField>

## Response

<ResponseField name="result">
  <Expandable title="properties" defaultOpen>
    <ResponseField name="overrideId" type="string" required>
      The id of the override that was set.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```ts theme={"theme":"kanagawa-wave"}
  const { meta, data } = await unkey.setOverride({
      identifier: "user_123",
      limit: 10,
      duration: 60000,
      namespaceName: "email.outbound",
      async: true
  })
  ```

  ```ts theme={"theme":"kanagawa-wave"}
  const { meta, data } = await unkey.setOverride({
    identifier: "user_123",
    limit: 5,
    duration: 50000,
    namespaceId: "rlns_1234",
    async: false,
  });
  ```
</RequestExample>

<ResponseExample>
  ```ts theme={"theme":"kanagawa-wave"}
  {
    result: {
       overrideId: 'rlor_12345'
    }
  }
  ```
</ResponseExample>