POSThttps://api.veriko.mx/v1/validations/{id}/cancel-retries

Cancelar reintentos pendientes

Audiencia: public
Autenticación: API key
Permiso: validations:read

Cancela el ciclo activo de reintentos automáticos de una validación y devuelve terminal_state="cancelled".

Si el ciclo ya no está activo, responde con un estado HTTP 422 (con retry_not_active en el cuerpo).

La cabecera opcional Idempotency-Key permite repetir la misma petición sin duplicar la cancelación.

Parámetros
Parámetro	Ubicación	Tipo	Obligatorio	Descripción
`id`*	path	`string (uuid)`	obligatorio	Identificador (UUID) de la validación
`Idempotency-Key`	header	`string`	opcional	Llave opcional que garantiza que la petición se procese exactamente una vez dentro de un TTL de 24 horas. Los reintentos con la misma llave y el mismo cuerpo devuelven la respuesta cacheada con la cabecera `Idempotent-Replayed: true` (sin re-disparar webhooks) y sin crear una nueva validación. p. ej. `11111111-2222-3333-4444-555555555555`

Petición

cURLPython•JavaScript•PHP•

curl -X POST 'https://api.veriko.mx/v1/validations/{id}/cancel-retries' \
  -H 'Authorization: Bearer veriko_••••' \
  -H 'Content-Type: application/json'

Ejemplo en Python — próximamente.

Ejemplo en JavaScript — próximamente.

Ejemplo en PHP — próximamente.

**Respuesta 200**`CancelValidationRetriesAttributes` — Ciclo de reintentos cancelado. `retry_state.terminal_state` queda `cancelled`.
Campo	Tipo	Descripción
`retry_state`	`object`	Estado completo del ciclo de reintentos, con configuración, avance y situación actual.
`enabled`	`boolean`	`true` cuando la validación tiene reintentos configurados, aunque su ciclo ya haya terminado (`terminal_state`). p. ej. `true`
`max_retries`	`integer \| null`anulable	Número máximo de reintentos configurado; `null` cuando `enabled` es `false`. p. ej. `3`
`interval_seconds`	`integer \| null`anulable	Intervalo en segundos entre reintentos, de `300` a `86400`; `null` cuando `enabled` es `false`. p. ej. `600`
`outcomes`	`array \| null`anulable	Resultados que originan un reintento: `not_found`, `cep_unavailable` y `error`; `null` cuando `enabled` es `false`. p. ej. `["not_found","cep_unavailable","error"]`
`attempts_completed`	`integer`	Cantidad de reintentos completados hasta el momento. p. ej. `1`
`next_attempt_at`	`TimestampUTC \| null`	Fecha del próximo reintento; `null` cuando no hay uno programado.
`resolved_at`	`TimestampUTC \| null`	Fecha en que un reintento obtuvo `valid`; `null` mientras no ocurra.
`exhausted_at`	`TimestampUTC \| null`	Fecha en que se agotaron los intentos; `null` mientras no ocurra.
`cancelled_at`	`TimestampUTC \| null`	Fecha de cancelación del ciclo; `null` mientras no ocurra.
`terminal_state`	`string \| null`anulable	Situación del ciclo: `pending`, `resolved`, `exhausted` o `cancelled`. Es `null` cuando la validación no tiene un ciclo de reintentos. p. ej. `pending`

**Códigos de respuesta**`POST /v1/validations/{id}/cancel-retries`
Código	Clase	Descripción	Cuerpo
200	`2xx`	Ciclo de reintentos cancelado. `retry_state.terminal_state` queda `cancelled`.	`CancelValidationRetriesAttributes`
401	`4xx`	Se requiere autenticación o las credenciales son inválidas	`ErrorResponse`
403	`4xx`	Permisos insuficientes	`ErrorResponse`
404	`4xx`	Validación no encontrada o ajena a la cuenta de usuario (`not_found`).	`ErrorResponse`
410	`4xx`	La validación se purgó y este recurso ya no existe (`validation_purged`).	`ErrorResponse`
422	`4xx`	No hay ciclo de reintentos activo que cancelar (código `retry_not_active`). UUID inválido (`invalid_uuid`).	`ErrorResponse`

**Cabeceras de respuesta**`200`
Cabecera	Tipo	Descripción
`Idempotent-Replayed`	`string`	Solo está presente cuando la petición incluyó `Idempotency-Key`. `true` indica que la respuesta se reutilizó desde el caché de idempotencia, cuya vigencia es de 24 horas por cuenta, endpoint y clave.

**Errores de `POST /v1/validations/{id}/cancel-retries`**
Código	Clave	Ejemplo
401	`unauthorized`	Credenciales de autenticación ausentes o inválidas. Envelope meta.request_id `c4d5e6f7a8b99b8a7f6e5d4c`
403	`permission_denied`	No tienes permiso para acceder a este recurso. Envelope meta.request_id `d5e6f7a8b9c00c9b8a7f6e5d`
410	`validation_purged`	La validación se purgó y este recurso ya no existe. Envelope meta.request_id `1a2b3c4d5e6ff6e5d4c3b2a1`