Criar ação de conciliação
Registra uma ação de recuperação do operador sobre um caso de conciliação. As ações válidas são ACKNOWLEDGE, RESOLVE, DISMISS, INVESTIGATE. Casos terminais (RESOLVED / DISMISSED) rejeitam ações adicionais com SPB-3007 / HTTP 409.
Autorizações
JWT bearer token issued by the identity provider.
Cabeçalhos
Idempotency key (canonical).
Idempotency key (legacy alias).
Idempotency key TTL in seconds (overrides the configured default).
Parâmetros de caminho
Reconciliation case UUID.
Corpo
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).
Resposta
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"

