Create reconciliation action
Records an operator recovery action on a reconciliation case. Valid actions are ACKNOWLEDGE, RESOLVE, DISMISS, INVESTIGATE. Terminal cases (RESOLVED / DISMISSED) reject further actions with SPB-3007 / HTTP 409.
Authorizations
JWT bearer token issued by the identity provider.
Headers
Idempotency key (canonical).
Idempotency key (legacy alias).
Idempotency key TTL in seconds (overrides the configured default).
Path Parameters
Reconciliation case UUID.
Body
Recovery action to record: ACKNOWLEDGE, RESOLVE, DISMISS, or INVESTIGATE.
"ACKNOWLEDGE"
Operator-supplied human-readable rationale for the action (max 512 chars).
"investigating with bank"
Optional sanitized JSON object with additional action context (no PII).
Response
OK
UUID of the newly recorded reconciliation action.
"b4e8f1a2-6c3d-4f57-9a10-1e1234567893"
UUID of the audit record linked to the action; empty when audit emission was disabled or failed (best-effort).
"c5f9a2b3-7d4e-4068-ab21-1e1234567894"
The reconciliation case after the action transition was applied.
Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.
Resulting case status after the action: OPEN, IN_PROGRESS, RESOLVED, or DISMISSED.
"IN_PROGRESS"

