> ## Documentation Index
> Fetch the complete documentation index at: https://docs.watahub.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Errores y reintentos

> Distingue el contrato de error antes de reintentar.

La API `/v1` puede devolver `GatewayError`, `ValidationError` o `MetaError`. Las rutas compatibles con Graph pueden devolver el cuerpo `GraphError` y estado originales de Meta. No uses un único parser para ambas interfaces.

Estados comunes: `401` por claves inválidas, `402` por pago, `404` por recursos inexistentes o ajenos, `409` por conflictos, `422` por validación del core, `429` por límites y `503` por gateway pausado o sin configurar. Revisa la referencia de cada operación.

## Evita duplicados

`unknown_outcome` significa que un envío podría haberse realizado. Consulta eventos e historial antes de reintentar. Un timeout o error del servidor no demuestra que no pasó nada.

Ante `429`, respeta `Retry-After` cuando exista. Limita reintentos y aplica esperas crecientes; no presupongas una cuota universal.

## Diagnostica de forma segura

`GET /v1/logs` filtra por `origin` (`api`, `meta`, `webhook`) y errores (`errors=1` o `errors=true`). El contrato describe hasta 200 entradas durante siete días; no registra cuerpos.

Ante un `500` con `requestId`, facilita ese ID a soporte, no claves ni mensajes de clientes.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.