Skip to main content
POST
Criar ação de conciliação

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency
string

Idempotency key (canonical).

X-Idempotency-Key
string

Idempotency key (legacy alias).

X-TTL
string

Idempotency key TTL in seconds (overrides the configured default).

Parâmetros de caminho

reconciliationId
string
obrigatório

Reconciliation case UUID.

Corpo

application/json
action
string
obrigatório

Recovery action to record: ACKNOWLEDGE, RESOLVE, DISMISS, or INVESTIGATE.

Exemplo:

"ACKNOWLEDGE"

reason
string
obrigatório

Operator-supplied human-readable rationale for the action (max 512 chars).

Exemplo:

"investigating with bank"

metadata
object

Optional sanitized JSON object with additional action context (no PII).

Resposta

OK

actionId
string
obrigatório

UUID of the newly recorded reconciliation action.

Exemplo:

"b4e8f1a2-6c3d-4f57-9a10-1e1234567893"

auditId
string
obrigatório

UUID of the audit record linked to the action; empty when audit emission was disabled or failed (best-effort).

Exemplo:

"c5f9a2b3-7d4e-4068-ab21-1e1234567894"

case
object
obrigatório

The reconciliation case after the action transition was applied.

correlationId
string
obrigatório

Request-scoped correlation identifier echoing X-Request-ID, for pivoting from response to trace.

status
string
obrigatório

Resulting case status after the action: OPEN, IN_PROGRESS, RESOLVED, or DISMISSED.

Exemplo:

"IN_PROGRESS"