Sign in
Legal Entity Change Events

Update legal entity change event (mutable fields only)

Updates mutable fields of an existing legal entity change event.

Only non-system fields are mutable: event_status, change_channel, acmt_instruction_id, acmt_confirmation_id, account_holder_id, beneficial_owner_id.

System-generated fields (changes, previous_state, legal_entity_id) are immutable after creation and are ignored even if provided.

put/api/legal-entity-change-events/{id}

Request

  • Base URL: http://localhost:4100
  • URL: http://localhost:4100/api/legal-entity-change-events/{id}
  • Auth: none required

Path parameters

idstring uuid required

Legal entity change event ID

Request body

account_holder_idstring uuid nullable

AccountHolder context link (nullable — event may affect both threads)

acmt_confirmation_idstring nullable

acmt:002 MsgId — confirmation message reference, populated once confirmed

acmt_instruction_idstring nullable

acmt:006 MsgId — upsert deduplication key. Unique per tenant when set (sparse unique index)

beneficial_owner_idstring uuid nullable

BeneficialOwner context link (nullable — event may affect both threads)

change_channel'web' | 'mobile' | 'branch' | 'api' | 'phone_banking' required

Channel through which the modification request was received

event_status'pending' | 'confirmed' | 'rejected' | 'recorded' nullable

Lifecycle status — pending (change requested), confirmed (verified and applied), rejected (denied by compliance / KYC check), recorded (automatically set by DB trigger for system-generated events)

event_type'address_change' | 'phone_change' | 'email_change' | 'beneficiary_added' | 'beneficiary_removed' | 'beneficiary_modified' | 'account_inquiry' | 'contact_info_change' | 'authorised_signer_change' required

Type of identity change — maps to acmt:006 MdcnCd (Modification Code). Primary AML signals: phone_change (SIM swap), address_change (address control), beneficiary_added / authorised_signer_change (pre-transfer grooming)

legal_entity_idstring uuid required
tenant_idstring uuid required

Example request

{
  "account_holder_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "acmt_confirmation_id": "",
  "acmt_instruction_id": "",
  "beneficial_owner_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "change_channel": "web",
  "event_status": "pending",
  "event_type": "address_change",
  "legal_entity_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "tenant_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6"
}

Changes

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