Saltar al contenido principal
POST
Resolve an executor human decision

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Parámetros de ruta

orderId
string
requerido

The executor order's identifier (UUID).

Ejemplo:

"0b9b7c2e-4f8a-4d3e-9a51-7c2d1e0f3a44"

revision
integer<int64>
requerido

The order revision (>= 1).

Rango requerido: x >= 1
Ejemplo:

1

Cuerpo

application/json
decisionId
string

Required. Journal row id of the human-decision request being answered: the revision's LATEST request. A request raised again after it makes this one stale (409 SBJ-0051), so a retry never resolves an occurrence nobody reviewed.

Ejemplo:

"7d1e8400-e29b-41d4-a716-446655440000"

ledgerEvidence
object

Required when the revision is UNCERTAIN: the executor raised moved-needs-human and the journal holds no posted row nor a moving effect, so only the ledger tells whether money moved (missing: 422 SBJ-0052). Optional otherwise, validated whenever present, and it never changes which resolution the journal admits. Stored only in the sealed audit row; never echoed, logged nor traced. On an acknowledgement, a transaction reference is also journaled as the ledger transaction the human read.

movedAmount
string

The TOTAL, a decimal string above zero (e.g. 150.00), that left the block account for this leg, including any effect the executor already read: an effect of the executor on the same release counts once, never added to it. Required, with a transaction ledgerEvidence, to acknowledge the effect of a release (UNBLOCK or TRANSFER) whose parent block landed without its origin legs: the executor could not plan that return, and the block counts as released only when the acknowledged amounts equal what it holds. Refused anywhere else (422 SBJ-0052); a transaction ledgerEvidence that is the executor's own effect is refused (409 SBJ-0064). Journaled; never echoed, logged nor audited.

Ejemplo:

"150.00"

reason
string

Required. Short justification or ticket reference (at most 200 characters, no personal data: CPF, CNPJ, judicial process numbers). Never echoed.

Ejemplo:

"OPS-4512: ledger statement reviewed with the institution."

resolution
string

Required. proven-no-effect: the ledger evidence shows the revision's writes never landed (refused with 409 SBJ-0054 when the journal shows money moved). effect-acknowledged: the effect is acknowledged as it is (refused with 409 SBJ-0055 when the journal shows no landed effect).

Ejemplo:

"effect-acknowledged"

Respuesta

OK

keys
integer<int64>
requerido

How many keys the resolution was journaled under by this request (the revision's unresolved request keys; 0 on NOOP).

orderId
string
requerido

The executor order's identifier.

outcome
enum<string>
requerido

RESOLVED: the resolution was journaled now. NOOP: the same resolution was already journaled under every key; nothing changed.

Opciones disponibles:
RESOLVED,
NOOP
resolution
string
requerido

The resolution journaled, as requested.

resolvedAt
string<date-time>
requerido

Instant of the request (UTC).

resolvedBy
string
requerido

Subject of the platform administrator who made the request.

revision
integer<int64>
requerido

The order revision.