Flow Studio
Rule Evaluation Audit
Storing rule evaluation decisions in the audit log for compliance — what is recorded, how to query decisions, and the retention policy.
What is Recorded
When storeAuditRecord: true (the default), the executor writes a rule evaluation audit record containing:
| Field | Description |
|---|---|
auditId | Unique audit record ID |
executionId | The workflow execution that triggered this evaluation |
nodeId | The specific RuleEvalNode within the workflow |
tenantId | Tenant scope |
actorId | The actor who triggered the execution |
ruleSetId | Rule set evaluated |
ruleSetVersion | Exact version of the rule set used |
facts | The complete fact object passed to the rule engine (input snapshot) |
outcome | The outcome returned |
firedRules | Rules that fired |
explanation | Human-readable explanation |
evaluatedAt | Timestamp of the evaluation |
Querying Audit Records
GET /api/rule-audit?executionId=exec-abc123
GET /api/rule-audit?ruleSetId=invoice-approval-policy-v2&from=2026-05-01&to=2026-05-31
GET /api/rule-audit?outcome=rejected&tenantId=tenant-acme
Compliance requirement: For financial and regulatory workflows, rule audit records must be retained for the legally required period (commonly 7 years for financial records). Ensure the audit log retention policy is configured accordingly. Disabling
storeAuditRecord for compliance-sensitive workflows is a compliance defect.