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

# Errores

> Cómo reporta las fallas la API

Las fallas devuelven la misma envoltura `{message, error, data}` que los casos exitosos, con `error: true` y un código de estado HTTP que señala el tipo de falla.

```json theme={null}
{
  "message": "Validation failed",
  "error": true,
  "data": {
    "detail": "..."
  }
}
```

## Códigos de estado

| Estado | Significado                                                                                                           |
| ------ | --------------------------------------------------------------------------------------------------------------------- |
| `400`  | Falló la validación — `data` describe los campos inválidos                                                            |
| `401`  | Clave API ausente, inválida, expirada o deshabilitada                                                                 |
| `403`  | El miembro dueño de la clave no tiene permiso sobre esta entidad o registro                                           |
| `404`  | Registro no encontrado en el espacio de trabajo de la clave                                                           |
| `409`  | Conflicto — por ejemplo, eliminar un registro que aún tiene registros relacionados activos; `data.blocking` los lista |
| `429`  | Límite de tasa superado — reintenta cuando se reinicie la ventana                                                     |

## Conflictos al eliminar

`DELETE` realiza una eliminación lógica. Si hay registros relacionados activos que dependen del registro, la API se niega con `409` y lista los registros que bloquean la operación para que los resuelvas primero:

```json theme={null}
{
  "message": "Cannot delete: active related records exist.",
  "error": true,
  "data": {
    "blocking": []
  }
}
```

## Límite de tasa

Las respuestas `429` indican que la clave agotó su ventana horaria. Revisa los encabezados `X-RateLimit-Remaining` y `X-RateLimit-Reset` de las respuestas anteriores para dosificar tus solicitudes — consulta [Autenticación](/docs/es/api-reference/authentication).