Skip to main content
POST
Run a retained message's routing decision again

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency
string
requerido

Idempotency key; a retry with the same key and body replays the first answer.

Parámetros de ruta

messageId
string<uuid>
requerido

The message's surrogate id, from the listing.

Cuerpo

application/json
reason
string
requerido

Why the decision should be run again. 1 to 512 characters after trimming.

Respuesta

Accepted

channelId
enum<string>
requerido
Opciones disponibles:
spb,
pix
messageId
string<uuid>
requerido
receivedAt
string<date-time>
requerido
reevaluatedAt
string<date-time> | null
requerido

The last time the rail tried its routing decision again and the message stayed retained, whether the decision ran or failed; null when it never tried.

releasable
boolean
requerido

True when the cause is routing or delivery: no owner in the map, a map that could not answer, an owner disabled or unreachable, no delivery mode declared for its code. Only these are re-checked by themselves once the cause lifts, and only these can be re-evaluated; a Pix retention also clears when the vendor resends it. An UNRECOGNIZED_TYPE of a non-financial code releases once a delivery mode is declared for its code and is not re-checked before that; one of a financial code releases on the re-check after a Courier release reads its destination.

retainedAt
string<date-time>
requerido
retentionReason
string
requerido
reevaluation
object

The last operator request to re-evaluate it; null when nobody asked.