Skip to main content

Overview

Event schemas let you control which actions are accepted by your workspace. Define action patterns with optional wildcards and choose between strict or permissive enforcement.

Action Patterns

Patterns use dot-separated segments with optional wildcard (*) at the end:
PatternMatches
document.createdOnly document.created
document.*document.created, document.updated, document.deleted, etc.
user.role.*user.role.assigned, user.role.removed, etc.
*Any single-segment action

Enforcement Modes

Strict Mode

Events with actions that do not match any defined pattern are rejected with a 422 error. Use this in production to prevent unexpected action strings from entering your audit log.

Permissive Mode

All events are accepted regardless of whether they match a pattern. Non-matching actions are flagged but still recorded. Use this during development or migration.

Strict Mode Error Response

{
  "error": "validation_failed",
  "message": "Action 'billing.refunded' does not match any configured schema pattern."
}

Configuration

Configure schemas from Settings > Schemas in the dashboard. Each schema entry consists of:
  • Pattern — The action pattern to match (e.g. document.*)
  • Description — Optional description of what this pattern covers
Schema enforcement is optional. If no schemas are configured, all actions are accepted regardless of the enforcement mode setting.

Plan Quotas

PlanSchema Limit
Free5
Starter15
Pro50
EnterpriseUnlimited