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

# Errores

> Gestiona los errores de la API v1 y los identificadores de correlación.

La API v1 devuelve los errores como JSON dentro de la propiedad `error`:

```json theme={null}
{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required."
  }
}
```

`code` es el valor que debes procesar en tu aplicación. `message` contiene una
descripción breve. Algunos errores también incluyen `details` y
`correlation_id`.

## Códigos de estado

Usa el estado HTTP junto con `error.code`:

| Estado | Significado |
| - | - |
| `400` | No se pudo interpretar la solicitud. |
| `401` | La solicitud no incluye una credencial de API aceptada. |
| `403` | La credencial no tiene el permiso o acceso a la cuenta requeridos. |
| `404` | No se encontró el recurso solicitado. |
| `409` | El cambio entra en conflicto con el estado actual del recurso. |
| `413` | El cuerpo supera un límite de la solicitud. |
| `415` | El cuerpo no usa un tipo de contenido JSON aceptado. |
| `422` | La solicitud no cumple el contrato del endpoint. |
| `429` | La solicitud superó un límite. |
| `500` | La API no pudo generar una respuesta válida. |
| `503` | Un servicio necesario no estaba disponible. |

La referencia de cada endpoint muestra los códigos de error exactos que
puede devolver.

## Identificadores de correlación

Cada respuesta de la API v1 incluye `X-Correlation-ID`. El cuerpo de un error
también puede incluir el mismo valor en `error.correlation_id`.

Cuando investigues una solicitud fallida, registra el identificador de
correlación junto con el estado y `error.code`. No registres la credencial
Bearer ni campos de respuesta que puedan contener datos personales.

## Decisiones de reintento

* Para `429`, espera el número de segundos indicado en `Retry-After` antes de
  reintentar.
* Para `503`, no trates la respuesta como si restableciera una cuota. Una
  interrupción del limitador usa `rate_limiter_unavailable` y no incluye
  `Retry-After`.
* Para `401` o `403`, corrige la credencial, el permiso o el acceso a la cuenta
  en lugar de repetir la misma solicitud.
* Para `422`, corrige la solicitud con ayuda de la referencia del endpoint.

Consulta [Límites de solicitudes](/es/guides/rate-limits) para conocer el
comportamiento completo de `429`.


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