Last updated 2026-05-18

Limits

A limit is a concrete enforcement rule supplied by the caller on each RPC. It combines a scope, action, unit, algorithm, window, and numeric limit.

Scope key

The identity being counted. Examples: user:user_123, org:org_456, ip:203.0.113.10, provider:openai.

Action

The usage dimension. Examples: workspace.email.recipients, education.download.bytes, assistant.llm.tokens.

Cost

The amount to consume or reserve. The service treats cost as an integer and does not infer units.

Validation

Required fields are limit_id, scope_key, action, unit, algorithm, and a positive limit. Window fields depend on the algorithm.