Rearm a parked executor result

Gives a result outbox row parked at the drainer’s attempt cap (EXECUTOR_RESULT_MAX_ATTEMPTS) its way out: attempts go back to 0 and the drainer retries it at once, so later versions of the same order held behind it can follow. A human platform-administrator action (executor_result:rearm, never held by M2M): an application token (SBJ-0044) or a tenant-carrying token (SBJ-0045) is refused with 403. The reset, its journal row and its audit row commit in one transaction. Every attempt with a known result, accepted or refused, is recorded append-only in the audit trail with the reason. 200 outcome NOOP: the result is pending but not parked (nothing changed). 409 SBJ-0048: the result is terminal. 422 SBJ-0049: reason missing, blank, longer than 200 characters or containing personal data. 422 SBJ-0050: multi-tenant deployment (the rearm is single-tenant only). 404: unknown result.

POST /v1/admin/executor/orders/{orderId}/revisions/{revision}/results/{executionVersion}/rearm

Rearm a parked executor result

cURL

curl --request POST \
  --url https://api.example.com/v1/admin/executor/orders/{orderId}/revisions/{revision}/results/{executionVersion}/rearm \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "reason": "Mensageria outage fixed; re-sending the parked result."
}
'

200

{
  "attemptsBefore": 123,
  "executionVersion": 123,
  "orderId": "<string>",
  "outcome": "REARMED",
  "rearmedAt": "2023-11-07T05:31:56Z",
  "rearmedBy": "<string>",
  "revision": 123
}

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

executionVersion · integer<int64> · requerido

The result's execution version (>= 1).

Rango requerido: x >= 1

Ejemplo:

1

Cuerpo

application/json

reason · string

Required. Short justification (at most 200 characters, no personal data: CPF, CNPJ, judicial process numbers). Stored sealed in the audit trail; never echoed.

Ejemplo:

"Mensageria outage fixed; re-sending the parked result."

Respuesta

200

application/json

OK

attemptsBefore · integer<int64> · requerido

The row's attempts when the request read it.

executionVersion · integer<int64> · requerido

The result's execution version.

orderId · string · requerido

The executor order's identifier.

outcome · enum<string> · requerido

REARMED: attempts reset to 0, the drainer retries it now. NOOP: the result was pending but not parked; nothing changed.

Opciones disponibles: REARMED, NOOP

rearmedAt · string<date-time> · requerido

Instant of the request (UTC).

rearmedBy · string · requerido

Subject of the platform administrator who made the request.

revision · integer<int64> · requerido

The order revision.