Skip to main content

BRE connector — overview

The BRE connector is Ark's business rules engine. It exposes a REST API to manage rule definitions (CRUD) and to evaluate them against supplied input. Rules are authored as JDM (JSON Decision Model) decision graphs and evaluated in-process. There is no external vendor — this is a self-contained internal service.

This is the connector BRE (the in-process JDM rules connector). It is distinct from the platform's internal routing rules; do not conflate the two.

What it does

CapabilityEndpoint
Evaluate a rulePOST /v1/rules/{ruleKey}/evaluate
List rulesGET /v1/rules
Get a rule (with JDM)GET /v1/rules/{ruleKey}
Create a rulePOST /v1/rules
Update a rulePUT /v1/rules/{ruleKey}
Deactivate a ruleDELETE /v1/rules/{ruleKey}

See endpoints for how to call them and lifecycle for a rule's status/versioning.

Shape

  • Self-contained. No external API; rule definitions are stored locally and execute in-process.
  • Versioned, cached decisions. Each rule has a version (incremented on update); compiled decisions are cached per version so repeat evaluations skip recompilation.
  • Sensitive input. Evaluation context/result may contain AML/KYC data and are never logged.
You want…Doc
How to call the APIendpoints (non-dev)
A rule's status & versioninglifecycle (non-dev)
How it's built and per-endpoint internalsarchitecture (dev)
How to build, run, test, and regenerate clientsdevelopment (dev)
Quirks and caveatsnotes (dev)

The formal request/response contract is the connector's OpenAPI specification (the Business Rules Engine API, openapi/source/connector/bre/bre.yml); this doc set does not restate it.