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

Autorizações

Authorization
string
header
obrigatório

JWT bearer token issued by the identity provider.

Cabeçalhos

X-Idempotency
string
obrigatório

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

Parâmetros de caminho

messageId
string<uuid>
obrigatório

The message's surrogate id, from the listing.

Corpo

application/json
reason
string
obrigatório

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

Resposta

Accepted

channelId
enum<string>
obrigatório
Opções disponíveis:
spb,
pix
messageId
string<uuid>
obrigatório
receivedAt
string<date-time>
obrigatório
reevaluatedAt
string<date-time> | null
obrigatório

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
obrigatório

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>
obrigatório
retentionReason
string
obrigatório
reevaluation
object

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