RatelimitOverride

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/RatelimitOverride",
  "title": "RatelimitOverride",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "overrideId": {
      "description": "The unique identifier of this specific rate limit override. This ID is generated when the override is created and can be used for management operations like updating or deleting the override.",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "duration": {
      "description": "The duration in milliseconds for this override's rate limit window. This may differ from the default duration for the namespace, allowing custom time windows for specific entities. After this duration elapses, the rate limit counter for affected identifiers resets to zero.",
      "format": "int64",
      "type": "integer",
      "minimum": 1000
    },
    "identifier": {
      "description": "The identifier pattern this override applies to. This determines which entities receive the custom rate limit.\n\nThis can be:\n- An exact identifier for a specific entity\n- A pattern with wildcards for matching multiple entities\n\nWildcard examples:\n- 'admin_*' matches any identifier starting with 'admin_'\n- '*_test' matches any identifier ending with '_test'\n- '*premium*' matches any identifier containing 'premium'\n\nMore complex patterns can combine multiple wildcards. Detailed documentation on pattern matching rules is available at https://www.unkey.com/docs/ratelimiting/overrides#wildcard-rules",
      "type": "string",
      "minLength": 1,
      "maxLength": 255
    },
    "limit": {
      "description": "The maximum number of requests allowed for entities matching this override. This replaces the default limit for the namespace when applied.\n\nCommon use cases:\n- Higher limits for premium customers\n- Reduced limits for abusive or suspicious entities\n- Zero limit to completely block specific patterns\n- Custom tier-based limits for different customer segments",
      "format": "int64",
      "type": "integer",
      "minimum": 0
    }
  },
  "required": [
    "overrideId",
    "duration",
    "identifier",
    "limit"
  ]
}