Sign in
latestOpenAPI 3.1.0MIT2026-08-226224149.1 KB

613ceff68dc7

Create a reconciliation rule

post/reconciliation_rules

Request body

reconciliation_idstring required
filtersFilters required— unresolved $ref
priorityinteger
group_byGroupBy — unresolved $ref
cardinalityCardinality — unresolved $ref
rollupRollup — unresolved $ref
descriptionstring

Optional human-readable description of what this rule matches

Response

Rule created

idinteger
priorityinteger

Lower values run first

group_bystring[]

Side A field keys to group records by before matching. The first key is the primary axis: in rollup.group_by_kind 'date' mode it must be a date field; in 'identifier' mode it can be any field (e.g. a batch id in metadata). Additional keys further segment Side A — in date mode each segment matches only Side B records with the same value for those fields; in identifier mode they form a composite cohort key.

cardinality'one_to_one' | 'many_to_one'

Match cardinality. 'one_to_one' matches single records on each side. 'many_to_one' rolls up multiple records on one side to match a single record on the other side — requires the rollup field to be set.

descriptionstring

Optional human-readable description of what this rule matches

source'user' | 'ai' | 'default'

Origin of the rule. 'user' = created manually via the API or UI. 'ai' = created by the AI rules engine. 'default' = seeded built-in rule.

status'active' | 'proposed'

Active rules are used by the reconciliation engine. Proposed rules are awaiting review from a cold start.

confidence'high' | 'medium' | 'low'

AI confidence rating. Only present on AI-generated rules from cold start.

sample_match_ratestring

How many sample records this rule matched during dry-run evaluation (e.g. '42/50'). Only present on AI-generated rules from cold start.

reconciliation_idinteger required
created_atstring date-time