Resolve an executor human decision

curl --request POST \
  --url https://api.example.com/v1/admin/executor/orders/{orderId}/revisions/{revision}/human-decision/resolution \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "decisionId": "7d1e8400-e29b-41d4-a716-446655440000",
  "ledgerEvidence": {
    "kind": "transaction",
    "observedAt": "2026-10-29T11:30:00Z",
    "reference": "midaz-tx-3f9a1c7e"
  },
  "movedAmount": "150.00",
  "reason": "OPS-4512: ledger statement reviewed with the institution.",
  "resolution": "effect-acknowledged"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/admin/executor/orders/{orderId}/revisions/{revision}/human-decision/resolution"

	payload := strings.NewReader("{\n  \"decisionId\": \"7d1e8400-e29b-41d4-a716-446655440000\",\n  \"ledgerEvidence\": {\n    \"kind\": \"transaction\",\n    \"observedAt\": \"2026-10-29T11:30:00Z\",\n    \"reference\": \"midaz-tx-3f9a1c7e\"\n  },\n  \"movedAmount\": \"150.00\",\n  \"reason\": \"OPS-4512: ledger statement reviewed with the institution.\",\n  \"resolution\": \"effect-acknowledged\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    decisionId: '7d1e8400-e29b-41d4-a716-446655440000',
    ledgerEvidence: {
      kind: 'transaction',
      observedAt: '2026-10-29T11:30:00Z',
      reference: 'midaz-tx-3f9a1c7e'
    },
    movedAmount: '150.00',
    reason: 'OPS-4512: ledger statement reviewed with the institution.',
    resolution: 'effect-acknowledged'
  })
};

fetch('https://api.example.com/v1/admin/executor/orders/{orderId}/revisions/{revision}/human-decision/resolution', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/admin/executor/orders/{orderId}/revisions/{revision}/human-decision/resolution"

payload = {
    "decisionId": "7d1e8400-e29b-41d4-a716-446655440000",
    "ledgerEvidence": {
        "kind": "transaction",
        "observedAt": "2026-10-29T11:30:00Z",
        "reference": "midaz-tx-3f9a1c7e"
    },
    "movedAmount": "150.00",
    "reason": "OPS-4512: ledger statement reviewed with the institution.",
    "resolution": "effect-acknowledged"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "keys": 123,
  "orderId": "<string>",
  "outcome": "RESOLVED",
  "resolution": "<string>",
  "resolvedAt": "2023-11-07T05:31:56Z",
  "resolvedBy": "<string>",
  "revision": 123
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

Resolve an executor human decision

The audited MANUAL resolution path of a single-tenant deployment: the only route that resolves an executor human decision. A multi-tenant deployment answers 422 SBJ-0053 before any read and must use the audited manual procedure instead. ledgerEvidence is REQUIRED when the revision is UNCERTAIN, and never changes the answer on a proven revision. Journals a human platform administrator’s resolution of the revision’s open human decision under every write key of the revision (one row with no key when it wrote nothing), so the open-order probe stops counting it under HumanDecision. Nothing is sent to any channel: the answer to the court stays with the institution. decisionId binds the resolution to the request it answers (the revision’s latest). A human platform-administrator action (executor_human_decision:resolve, never held by M2M): an application token (SBJ-0044) or a tenant-carrying token (SBJ-0045) is refused with 403. The rows and the audit row commit in one transaction. 200 outcome NOOP: the same resolution was already journaled. 409 SBJ-0051: no open human decision. 409 SBJ-0054: the journal contradicts the resolution (no effect declared on a PROVEN EFFECT revision, or an acknowledgment while the write is undetermined). 409 SBJ-0055: an acknowledgment on a PROVEN NO EFFECT revision. 409 SBJ-0064: an acknowledgment whose transaction ledgerEvidence is the executor’s own effect (a transaction its recovery probe recorded for the revision); movedAmount is the total that left the block account. Each revision is classified, under the same locks as the write, by its journal evidence: PROVEN EFFECT (a posted row or a moving effect) admits only the acknowledgment; PROVEN NO EFFECT (neither, and no moved-needs-human request) admits only the no-effect declaration; UNCERTAIN (a moved-needs-human request without a posted row or a moving effect) admits both, only with ledgerEvidence. 422 SBJ-0052: resolution, reason or ledgerEvidence invalid (reason missing, longer than 200 characters or with personal data), or an UNCERTAIN revision without ledgerEvidence, or movedAmount missing, invalid or not admitted. A release (UNBLOCK or TRANSFER) whose parent block landed without its origin legs is UNCERTAIN whatever its request: its acknowledgement requires movedAmount and a transaction ledgerEvidence. 422 SBJ-0053: multi-tenant deployment (single-tenant only; use the audited manual procedure). 404: unknown revision, or one of an institution this executor does not own (the same answer).

POST

admin

executor

orders

{orderId}

revisions

{revision}

human-decision

resolution

Resolve an executor human decision

curl --request POST \
  --url https://api.example.com/v1/admin/executor/orders/{orderId}/revisions/{revision}/human-decision/resolution \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "decisionId": "7d1e8400-e29b-41d4-a716-446655440000",
  "ledgerEvidence": {
    "kind": "transaction",
    "observedAt": "2026-10-29T11:30:00Z",
    "reference": "midaz-tx-3f9a1c7e"
  },
  "movedAmount": "150.00",
  "reason": "OPS-4512: ledger statement reviewed with the institution.",
  "resolution": "effect-acknowledged"
}
'

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/v1/admin/executor/orders/{orderId}/revisions/{revision}/human-decision/resolution"

	payload := strings.NewReader("{\n  \"decisionId\": \"7d1e8400-e29b-41d4-a716-446655440000\",\n  \"ledgerEvidence\": {\n    \"kind\": \"transaction\",\n    \"observedAt\": \"2026-10-29T11:30:00Z\",\n    \"reference\": \"midaz-tx-3f9a1c7e\"\n  },\n  \"movedAmount\": \"150.00\",\n  \"reason\": \"OPS-4512: ledger statement reviewed with the institution.\",\n  \"resolution\": \"effect-acknowledged\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    decisionId: '7d1e8400-e29b-41d4-a716-446655440000',
    ledgerEvidence: {
      kind: 'transaction',
      observedAt: '2026-10-29T11:30:00Z',
      reference: 'midaz-tx-3f9a1c7e'
    },
    movedAmount: '150.00',
    reason: 'OPS-4512: ledger statement reviewed with the institution.',
    resolution: 'effect-acknowledged'
  })
};

fetch('https://api.example.com/v1/admin/executor/orders/{orderId}/revisions/{revision}/human-decision/resolution', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.example.com/v1/admin/executor/orders/{orderId}/revisions/{revision}/human-decision/resolution"

payload = {
    "decisionId": "7d1e8400-e29b-41d4-a716-446655440000",
    "ledgerEvidence": {
        "kind": "transaction",
        "observedAt": "2026-10-29T11:30:00Z",
        "reference": "midaz-tx-3f9a1c7e"
    },
    "movedAmount": "150.00",
    "reason": "OPS-4512: ledger statement reviewed with the institution.",
    "resolution": "effect-acknowledged"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "keys": 123,
  "orderId": "<string>",
  "outcome": "RESOLVED",
  "resolution": "<string>",
  "resolvedAt": "2023-11-07T05:31:56Z",
  "resolvedBy": "<string>",
  "revision": 123
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "message": "<string>",
  "title": "<string>",
  "details": {}
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

{
  "code": "<string>",
  "detail": "Property foo is required but is missing.",
  "errors": [
    {
      "location": "<string>",
      "message": "<string>",
      "value": "<unknown>"
    }
  ],
  "instance": "https://example.com/error-log/abc123",
  "status": 400,
  "title": "Bad Request",
  "type": "https://example.com/errors/example",
  "upstream": {
    "code": "E4001",
    "message": "account not found at provider"
  }
}

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.

Show child attributes

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

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.

Instituciones y conector Midaz

Canal directo

Administración del canal directo

Órdenes que requieren atención

Enrutamiento de ledger

Auditoría

Manejo de errores

Resolve an executor human decision

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta