Saltar al contenido principal
POST
Retry a reconciliation job

Autorizaciones

Authorization
string
header
requerido

JWT bearer token issued by the identity provider.

Encabezados

X-Idempotency
string
requerido

REQUIRED. Client-supplied replay key, at most 64 bytes. A request without it is refused with PIX-0030 @ 400 before the handler runs. Replaying the same key with a divergent request is PIX-0031 @ 412 -- at the edge for one hour, and permanently thereafter from the administrative audit record.

Ejemplo:

"a1b2c3d4-0000-0000-0000-000000000001"

Parámetros de ruta

job_id
string
requerido

Reconciliation job to retry (UUID)

Ejemplo:

"019606a1-3b4c-7d8e-9f01-234567890abc"

Cuerpo

application/json
expectedStatus
string
requerido

Status the caller believes the job currently carries. The retry is refused with 409 PIX-0155 if the stored row disagrees, so this field is what makes the operation safe against a job that moved since it was read.

Ejemplo:

"FAILED"

reason
string
requerido

Operator justification for the intervention. Recorded permanently in the administrative audit log and read by humans during an audit; no code branches on it.

Ejemplo:

"BACEN CID file request wedged after a pod restart; reconciliation window closes at 18:00"

Respuesta

The retry was applied, or an identical X-Idempotency replay returned the outcome of the first request. sourceJobId is present only when the retry created a new job from a terminal one.

jobId
string
requerido

The job that will now run: the re-driven job for an in-place retry, or the newly created job when the retried one was terminal.

Ejemplo:

"019606a1-3b4c-7d8e-9f01-234567890abc"

previousStatus
string
requerido

Status the retried job carried immediately before this action.

Ejemplo:

"FAILED"

status
string
requerido

Status the retry left behind: the status the job was moved to, or PENDING for a newly created successor.

Ejemplo:

"PENDING"

sourceJobId
string

The terminal job this retry created a successor from. Absent when the retry re-drove the job in place.

Ejemplo:

"019606a1-3b4c-7d8e-9f01-2345678909fe"