Update case fees and/or principal

PUT 
/cases/:id/fees

Updates the interest, reminder, and collection fees — and optionally the principal (GrossAmount) — on a case.

All provided values replace the current values. The grossAmount field is optional and backward-compatible: omitting it leaves the principal unchanged.

Fees typically change over time as collection activity progresses — for example due to legal costs, attorney fees, investigation charges, or other events.

When grossAmount is supplied:

• Both increases and decreases are allowed (no restriction on direction)
• The pre-legal success fee (commission) is silently recalculated and returned in the response
• The outstanding remainder is recalculated to reflect the new principal
• A timeline audit event is written recording the change (From/To principal and fees)

Prerequisites:

• The case must be assigned to this collection partner
• The case must not be Closed or Merged (returns 400 otherwise)
• All amounts must be ≥ 0 (negative values rejected)

Request

Responses

200

Fees updated successfully

400

Validation error — invalid values, case is Closed or Merged, or confirmPriceChange=true was sent on a deliberately-set rate (accepted quote / manual override), which is preserve-only on this API — resubmit with keepIntentionalRate=true instead.

404

Case not found or not assigned to this collection partner

409

Price-change confirmation required — the principal edit would move the success fee by >0.1%. For a standard rate, resubmit with confirmPriceChange=true to re-price. For a deliberately-set rate (accepted quote / manual override) the rate is preserve-only: resubmit with keepIntentionalRate=true to apply the edit and keep the special rate — partners cannot override it (sending confirmPriceChange=true on such a case is rejected with 400).

500

Internal server error