Unkey · Schema

RatelimitResponse

API KeysRate LimitingAuthenticationDeveloper PlatformAccess ControlIdentityAnalytics

Properties

Name Type Description
id string Unique identifier for this rate limit configuration.
name string Human-readable name for this rate limit.
limit integer Maximum requests allowed within the time window.
duration integer Rate limit window duration in milliseconds.
autoApply boolean Whether this rate limit was automatically applied when verifying the key.
View JSON Schema on GitHub

JSON Schema

unkey-ratelimitresponse-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "#/components/schemas/RatelimitResponse",
  "title": "RatelimitResponse",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "minLength": 8,
      "maxLength": 255,
      "pattern": "^rl_[a-zA-Z0-9_]+$",
      "description": "Unique identifier for this rate limit configuration.",
      "example": "rl_1234567890abcdef"
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128,
      "description": "Human-readable name for this rate limit.",
      "example": "api_requests"
    },
    "limit": {
      "type": "integer",
      "format": "int64",
      "minimum": 1,
      "maximum": 1000000,
      "description": "Maximum requests allowed within the time window.",
      "example": 1000
    },
    "duration": {
      "type": "integer",
      "format": "int64",
      "minimum": 1000,
      "maximum": 2592000000,
      "description": "Rate limit window duration in milliseconds.",
      "example": 3600000
    },
    "autoApply": {
      "type": "boolean",
      "description": "Whether this rate limit was automatically applied when verifying the key.",
      "example": true
    }
  },
  "required": [
    "id",
    "name",
    "limit",
    "duration",
    "autoApply"
  ],
  "additionalProperties": false
}