Advanced implementation patterns and operational guidance — each guide is a complete, standalone reference for one part of the platform.
Entitlement patterns
Boolean gates, limit checks, and metered entitlements — the verdict model, resolution layering, and caching-safe recheck triggers.
Open guideCaching
What the API marks as cacheable, what to cache yourself, and the invalidation events that keep both layers correct.
Open guideMetering best practices
Idempotent usage submission, batching high-frequency meters, threshold UX, and drift reconciliation.
Open guideWebhook verification and retries
Register endpoints, verify signatures against the raw body, and process retried deliveries idempotently.
Open guideMigration guide
URL-path versioning, deprecation detection, dual-read fallbacks, and staged rollouts for breaking changes.
Open guideAudit and trace
Propagate request IDs end-to-end and correlate API activity, webhook deliveries, and the audit log.
Open guideEvents & Webhook Explorer
Browse every webhook event type with sample payloads, and verify signatures interactively.
Open guideNode SDK integration
Enriched decisions with reason codes, batch checks, caching with explicit degradation, credit reservations, and the SDK's two extension points.
Open guideClerk identity integration
Connect your Clerk instance to sync users and organizations as customers, then resolve sessions to customer ids on every request.
Open guidePostHog packaging analytics
Stream entitlement denials into your PostHog project — with explicit identity mapping, volume caps, and a preview of every event before anything is sent.
Open guideOpenTelemetry visibility
One-line decision spans and bounded metrics on your existing OTel setup, with a deep link from every span to the exact evaluation record.
Open guide