Create risk classification

Creates a new risk classification for an AccountHolder. When is_active: true (the default), any previously active classification for the same holder is deactivated atomically so the single-active invariant is preserved.

post/api/risk-classifications

Request

Base URL: http://localhost:4100
URL: http://localhost:4100/api/risk-classifications
Auth: none required

Request body

account_holder_idstring uuid required

classification_reasonstring required

Human-readable justification for the classification

classified_by_user_idstring uuid nullable

User who performed the classification (nil = auto-classified by engine)

compliance_screening_idstring uuid nullable

ComplianceScreening that drove this classification

effective_fromstring date required

Start date of the classification (inclusive)

effective_untilstring date nullable

End date of the classification (exclusive), nil = open-ended

is_activeboolean

True when this is the current active classification for the holder

notesstring nullable

Free-text analyst notes

risk_level'low' | 'medium' | 'high' | 'very_high' required

Risk level driving the LedgerAccount limit cascade

tenant_idstring uuid required

Example request

{
  "account_holder_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "classification_reason": "",
  "classified_by_user_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "compliance_screening_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "effective_from": "2020-04-20",
  "effective_until": "2020-04-20",
  "is_active": false,
  "notes": "",
  "risk_level": "low",
  "tenant_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6"
}

Changes

No recorded changes to this operation across all 4 revisions of this API.