Last updated 2026-05-18

Events

Usage events are append-only facts emitted asynchronously. They are useful for audit trails, offline analytics, and reconciliation, but the service does not expose historical analytics APIs in v1.

Event types

quota.consumed
quota.denied
quota.reserved
quota.reservation_finalized
quota.reservation_released
quota.lease_acquired
quota.lease_renewed
quota.lease_released

Example

{
  "event_type": "quota.consumed",
  "timestamp": "2026-05-17T12:00:00Z",
  "request_id": "req_123",
  "decision_id": "dec_456",
  "product": "workspace",
  "environment": "prod",
  "action": "workspace.email.recipients",
  "unit": "recipients",
  "cost": 25,
  "allowed": true,
  "limit_statuses": [{
    "limit_id": "user_email_daily",
    "scope_key": "user:user_123",
    "limit": 500,
    "used": 25,
    "remaining": 475
  }]
}