Event Catalog

Canonical list of every PlatformXe domain event you can subscribe to, grouped by service.

PlatformXe emits 134 typed domain events across 22 services. Every event constant lives in src/lib/events/platform-events.ts (PlatformEvents enum) — that file is the source of truth and the one this page mirrors. Names are SCREAMING_SNAKE_CASE and that's exactly the string you pass to event-subscriptions, use in workflow triggers, or match against in webhook handlers.

Bus shapes for each event live in @caldera/events — install the package and import the typed payload interface (e.g. RoleCreatedPayload) for compile-time safety in subscriber handlers. Subscribers can wildcard-match a service prefix (e.g. FRAUD_*) when developing, then narrow to specific events for production.

Authorization (10)

Event	Description
ROLE_CREATED	New permission role created.
ROLE_UPDATED	Role name/description/model edited.
ROLE_DELETED	Role deleted.
ROLE_CAPABILITIES_UPDATED	SIMPLE-model capability list changed for a role.
ROLE_MODULE_PERMISSIONS_UPDATED	FULL-model module/action grants changed for a role.
PERMISSION_OVERRIDE_CREATED	Per-user override added (allow or deny).
PERMISSION_OVERRIDE_DELETED	Per-user override removed.
RESOURCE_POLICY_CREATED	ABAC resource policy created.
RESOURCE_POLICY_UPDATED	ABAC resource policy edited.
RESOURCE_POLICY_DELETED	ABAC resource policy deleted.

Documents & Storage (6)

Event	Description
DOCUMENT_CREATED	Document record created.
DOCUMENT_UPDATED	Document metadata or content edited.
DOCUMENT_DELETED	Document deleted.
FOLDER_CREATED	Storage folder created.
FILE_UPLOADED	File uploaded to media or fixed storage.
FILE_DELETED	File removed.

Invoicing & Billing (6)

Event	Description
INVOICE_CREATED	New invoice generated.
INVOICE_PAID	Invoice marked paid (Flutterwave/Paystack settled).
INVOICE_CANCELLED	Invoice voided before settlement.
PLAN_UPGRADED	Subscription tier raised.
PLAN_DOWNGRADED	Subscription tier lowered.
SUBSCRIPTION_CANCELLED	Subscription cancelled outright.

Webhooks & Subscriptions (7)

Event	Description
WEBHOOK_CREATED	Outbound webhook endpoint registered.
WEBHOOK_UPDATED	Webhook config edited.
WEBHOOK_DELETED	Webhook endpoint removed.
WEBHOOK_SECRET_ROTATED	Webhook signing secret rotated.
EVENT_SUBSCRIPTION_CREATED	New event subscription created.
EVENT_SUBSCRIPTION_UPDATED	Subscription config (filters/active flag) edited.
EVENT_SUBSCRIPTION_DELETED	Subscription removed.

Tenant Lifecycle (3)

Event	Description
ORGANIZATION_CREATED	New tenant org provisioned.
TENANT_USER_CREATED	First (or new) user added to a tenant org.
API_KEY_GENERATED	API key issued for an org.

Auth & Security (4)

Event	Description
LOGIN_FAILED	Failed login attempt.
ACCOUNT_LOCKED	Account auto-locked after repeated failures.
SSO_USER_PROVISIONED	SSO just-in-time provisioned a new user.
SSO_CONFIG_UPDATED	Org SSO settings changed.

Passwordless Auth (6 — v1.19.0)

Event	Description
AUTH_CODE_REQUESTED	One-time login code requested.
AUTH_CODE_VERIFIED	Code accepted; session issued.
AUTH_CODE_FAILED	Code rejected (wrong/expired).
RECOVERY_CODE_USED	Recovery code consumed during account recovery.
RECOVERY_CODES_REGENERATED	New batch of recovery codes issued.
SESSION_REVOKED_ALL	All sessions for a user invalidated.

Branding (1)

Event	Description
ORGANIZATION_BRANDING_UPDATED	Tenant brand colors/logos/custom CSS edited.

Permission Federation (8)

The v1.x.x cross-app admin permission federation surface — distinct from the CUSTOM_EVENT_FEDERATION_* family below.

Event	Description
FEDERATION_GROUP_CREATED	Permission federation group created.
FEDERATION_GROUP_DELETED	Permission federation group archived.
FEDERATION_MEMBER_ADDED	Member org added to a permission federation group.
FEDERATION_MEMBER_REMOVED	Member org removed.
FEDERATION_PULL_COMPLETED	A module pull from a peer finished.
FEDERATION_PUSH_COMPLETED	A resolved-permissions push to a peer finished.
FEDERATION_SYNC_COMPLETED	Scheduled sync cycle finished.
FEDERATION_HEALTH_CHANGED	Group health (latency, error rate) changed bucket.

Identity Resolution (4)

Event	Description
IDENTITY_RESOLVED	Identity match returned.
IDENTITY_VERIFIED	Identity confirmed by upstream provider.
IDENTITY_LOOKUP	Identity lookup query executed.
IDENTITY_PROVIDER_DOWN	Upstream identity provider failed health checks.

Threads (17)

The Caldera Threads contextual-messaging surface.

Event	Description
THREAD_CHANNEL_CREATED	New thread channel created.
THREAD_CHANNEL_UPDATED	Channel config (slug, lifecycle, escalation) edited.
THREAD_CREATED	New thread opened in a channel.
THREAD_CLOSED	Thread marked closed.
THREAD_REOPENED	Closed thread reopened.
THREAD_MESSAGE_CREATED	Message posted to a thread.
THREAD_MESSAGE_EDITED	Message edited.
THREAD_MESSAGE_DELETED	Message deleted.
THREAD_PARTICIPANT_JOINED	Participant added to a thread.
THREAD_PARTICIPANT_LEFT	Participant removed/left.
THREAD_READ_UPDATED	Read marker advanced for a participant.
THREAD_MESSAGE_FLAGGED	Message flagged for moderation.
THREAD_ESCALATED	Thread escalated per channel rules.
THREAD_FLAG_REVIEWED	Moderator reviewed a flag (resolve/dismiss).
THREAD_ARCHIVED	Thread archived per retention policy.
THREAD_RETENTION_DELETED	Thread hard-deleted per retention policy.
THREAD_RETENTION_ANONYMIZED	Thread anonymized per retention policy.

Service Processors (1)

Event	Description
PROCESSOR_UPDATED	Tenant service processor (messaging/storage/OCR/PDF/etc.) config updated.

Fraud Detection — Phase 6A (18)

Event	Description
FRAUD_DECISION_RENDERED	Fraud engine returned a decision (any verdict).
FRAUD_DECISION_BLOCKED	Decision was block.
FRAUD_DECISION_STEP_UP	Decision was step_up (require additional verification).
FRAUD_DECISION_REVIEW	Decision was review (queue for manual review).
FRAUD_RULE_CREATED	Tenant rule created (status: draft).
FRAUD_RULE_PROMOTED_TO_SHADOW	Rule promoted to shadow mode (logs decisions, doesn't enforce).
FRAUD_RULE_PUBLISHED	Rule published (enforces decisions).
FRAUD_RULE_ARCHIVED	Rule archived.
FRAUD_RULE_TRIGGERED	Rule matched on a decision request.
FRAUD_SCREEN_HIT	Subject matched a screening list entry.
FRAUD_DEVICE_FIRST_SEEN	Device fingerprint observed for the first time.
FRAUD_DEVICE_ANOMALY	Device fingerprint flagged anomalous.
FRAUD_LIST_REFRESHED	Screening list updated (entries added/removed).
FRAUD_PROVIDER_DOWN	Upstream fraud signal provider failed health.
FRAUD_CASE_OPENED	Manual review case opened.
FRAUD_CASE_ESCALATED	Case escalated to a higher reviewer tier.
FRAUD_CASE_CLOSED	Case closed (approved/rejected).
SUSPICIOUS_ACTIVITY_FLAGGED	Engine flagged a generic suspicious-activity signal.

Identity Verification — Nigerian KYC, Phase 6F (7)

Event	Description
IDENTITY_BVN_VERIFIED	Bank Verification Number verified upstream.
IDENTITY_NIN_VERIFIED	National Identification Number verified upstream.
IDENTITY_LIVENESS_PASSED	Liveness check passed.
IDENTITY_LIVENESS_FAILED	Liveness check failed.
IDENTITY_FACE_MATCHED	Face match succeeded.
IDENTITY_ACCOUNT_VERIFIED	Bank account ownership verified.
IDENTITY_VERIFICATION_FAILED	Aggregate verification failed.

Identity DLQ — Phase 6F.5b (2)

Event	Description
IDENTITY_DLQ_RECORDED	Failed verification placed on the DLQ for replay.
IDENTITY_DLQ_REPLAYED	DLQ entry replayed successfully.

Fraud Federation — Phase 6G (1)

Event	Description
FRAUD_FEDERATION_PUSHED	Fraud signal pushed to a federation peer.

Fraud Detection T&Cs — Phase 6H (1)

Event	Description
FRAUD_TERMS_ACCEPTED	Tenant accepted current Fraud Detection terms version.

Tenant Custom Events — Registration (10 — Phase 9A)

Per-step lifecycle of registering / updating / archiving a tenant-defined custom event. Subscribers (federation push, drift detection, audit, billing meter, ops alerts, cache pub/sub) are decoupled — pick the event type that matches your concern. Full payload reference: docs/platformxe-tenant-custom-events-lifecycle-events.md.

Event	Description
CUSTOM_EVENT_REQUESTED	Register call received — pre-validation.
CUSTOM_EVENT_VALIDATION_FAILED	Schema/quota/allowlist validation failed.
CUSTOM_EVENT_VALIDATED	Validation passed.
CUSTOM_EVENT_PERSISTED	Row written to tenant_custom_event_registrations.
CUSTOM_EVENT_MATERIALISED	Bus-stable canonical name materialized.
CUSTOM_EVENT_REGISTERED	Umbrella — full pipeline succeeded.
CUSTOM_EVENT_UPDATED	Registration edited (description/status/marketplace metadata).
CUSTOM_EVENT_ARCHIVED	Registration archived.
CUSTOM_EVENT_INVALIDATED	Registration invalidated by ops/policy.
CUSTOM_EVENT_QUOTA_EXCEEDED	Registration count quota for the org exceeded.

Tenant Custom Events — Emit (6 — Phase 9A/9B)

Event	Description
CUSTOM_EVENT_EMIT_REQUESTED	Emit call received — pre-validation.
CUSTOM_EVENT_EMIT_REJECTED	Emit rejected (schema/quota/auth).
CUSTOM_EVENT_EMIT_RELAYED	Emit accepted and re-emitted on the bus.
CUSTOM_EVENT_EMIT_DELIVERED	Subscriber webhook received the relay successfully.
CUSTOM_EVENT_EMIT_DELIVERY_FAILED	Subscriber webhook delivery failed after retries.
CUSTOM_EVENT_EMIT_QUOTA_EXCEEDED	Per-org or per-event emit quota exceeded.

Tenant Custom Events — Infra (2)

Event	Description
CUSTOM_EVENT_GENERIC_SEEDED	Per-org generic catch-all event seeded on org creation/backfill.
CUSTOM_EVENT_CHAIN_TRUNCATED	51st emit in a workflow chain — capped at depth 50 per decision v2 §3.

Marketplace — Phase 9C (5)

Event	Description
MARKETPLACE_LISTING_PUBLISHED	New listing created from a published registration.
MARKETPLACE_LISTING_UNPUBLISHED	Publisher hid an active listing — existing forks unaffected.
MARKETPLACE_LISTING_REPUBLISHED	Previously-unpublished listing made visible again.
MARKETPLACE_LISTING_FORKED	Tenant forked a listing into their own org.
MARKETPLACE_LISTING_FORK_FAILED	Fork rejected by plan gate, allowlist, or duplicate (orgId, ns, name, version).

Custom Event Federation — Phase 9D + Pattern 3 (9)

ENTERPRISE-only fan-out of tenant custom events to peer orgs (Pattern 1: tenant_org peers) or arbitrary HTTPS endpoints (Pattern 3: external_webhook peers, v1.5.0). See Federation.

Event	Description
CUSTOM_EVENT_FEDERATION_GROUP_CREATED	Owner created a federation group.
CUSTOM_EVENT_FEDERATION_GROUP_ARCHIVED	Owner archived a group — pushes/members frozen, history preserved.
CUSTOM_EVENT_FEDERATION_MEMBER_INVITED	Owner invited a peer org or added an external webhook peer (state: pending or accepted).
CUSTOM_EVENT_FEDERATION_MEMBER_ACCEPTED	Member accepted (tenant_org) or auto-accepted at create time (external_webhook). Relays start flowing.
CUSTOM_EVENT_FEDERATION_MEMBER_REMOVED	Member removed by owner, left voluntarily, or kicked by plan downgrade.
CUSTOM_EVENT_FEDERATION_PUSH_DECLARED	Owner declared a per-version event push. Bus listener fans out from this point.
CUSTOM_EVENT_FEDERATION_PUSH_UNDECLARED	Owner stopped pushing a version. Fan-out halts; prior relays preserved.
CUSTOM_EVENT_FEDERATION_RELAYED	Successful relay of one emit to one peer (tenant or external).
CUSTOM_EVENT_FEDERATION_RELAY_FAILED	Relay attempt failed (peer paused/removed, schema drift, transport/HTTP error).