Skip to main content
Errors use a stable JSON shape: 
{
  "error": "api_key_scope_denied",
  "detail": "This API key is not allowed to query events."
}

​
Common statuses

400 The request body or query parameters are invalid. 401 The request is missing a bearer token or the token is invalid. 402 The workspace has reached its monthly event limit. 403 The API key is valid but does not have the required scope, project access, or action access. 409 The request conflicts with current workspace state. Examples include stale policy versions and archive queries missing includeArchive=true. 413 The event payload is too large. Event writes are capped before batching so single events stay reviewable.

​
Retry rules

Retry network failures and 5xx responses with the same idempotency key. Do not blindly retry validation, scope, stale policy, or plan-limit errors. Fix the request or workspace state first.