Check budget enforcement
Internal endpoint used by the gateway to resolve applicable budgets and check enforcement gates for a request. Returns allowed/rejected status with dimension info for rate-limit headers.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
API key that issued the request (if any).
Project the request targets (if any).
Identity external id for contact-scoped budgets (if any).
Provider enum value for provider-scoped budgets (if any).
Full model reference for model-scoped budgets (if any), exactly as the caller sent it: "provider/model" or "workspaceKey@provider/model".
Request metadata forwarded for dynamic-budget matching
(metadata.team == "ml"). Free-form JSON object from the request
body's metadata field.
Request headers (lowercase keys) forwarded for dynamic-budget
matching (headers["x-env"] == "prod").
Response
OK
True when no applicable budget exceeds its limit.
Populated when allowed is false; identifies which budget and dimension triggered the rejection.
Cost dimension info for rate-limit headers (nil when no cost budget applies).
Token dimension info for rate-limit headers (nil when no token budget applies).
Requests dimension info for rate-limit headers (nil when no RPM budget applies).