Minctrl Docs
Cookbook

AML alert triage

Onboard and screen a customer on the aml vertical, park at the BSA officer gate, sign it, and keep the run monitoring — every SAR and OFAC action stays shadowed until a human signs.

Scenario. A new customer is onboarded and screened against sanctions and adverse media. Clear, low-risk parties auto-onboard; a high-risk party is escalated, and a BSA/AML Officer must sign the high-risk onboarding, any OFAC action, and every SAR before it is filed.

Vertical: aml · Parks at gate step-id: bsa-gate (gate:bsa-officer-signoff).

1. Start the run

RUN=$(curl -s -X POST "$API/process-runs" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "vertical": "aml",
    "inputs": {
      "customer_name": "Jane Q. Public",
      "customer_country": "US",
      "customer_dob": "1980-04-12",
      "risk_band": "high"
    }
  }')
RUN_ID=$(echo "$RUN" | jq -r .id)

The run screens concurrently, scores onboarding risk, and — for a high-risk party — parks at the BSA officer gate.

2. Read where it parked

curl -s "$API/process-runs/$RUN_ID" -H "Authorization: Bearer $TOKEN"

status is awaiting_human. The trace shows the run parked at the bsa-gate step. Use that step-id to resume.

3. Resume — the BSA officer signs

curl -s -X POST "$API/process-runs/$RUN_ID/resume" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "gate": "bsa-gate",
    "decision": "onboarding approved"
  }'

decision records the officer's verdict. The bsa-gate routes on that verdict — for example onboarding approved, SAR signed, or sanctions hit confirmed: block/reject + OFAC report. A denial or reject verdict leaves downstream irreversible actions unauthorized.

4. Outcome — the run keeps monitoring

Unlike a one-shot approval, AML monitors continuously. After the signed onboarding decision is applied, the run maintains a monitoring loop, triaging transaction alerts; a true hit drafts a new SAR and parks again at the BSA gate. Expect this run to loop rather than terminate.

Governance note

The irreversible steps here — execute the OFAC action, apply the onboarding decision, and file the SAR with FinCEN — are reversible: false and stay shadowed (dry-run) until you opt a connector in. They only fire for real after the BSA officer's signed verdict authorizes them, and only if you have un-shadowed the connector deliberately.

On this page