Errores

La API usa códigos de estado HTTP estándar para indicar el resultado de cada petición.

Códigos de estado

Código	Significado
200 OK	Petición exitosa
201 Created	Recurso creado
400 Bad Request	Datos inválidos o mal formados
401 Unauthorized	Falta el token o es inválido
403 Forbidden	Sin permiso para el recurso o workspace
404 Not Found	El recurso no existe
409 Conflict	Conflicto (por ejemplo, un duplicado)
429 Too Many Requests	Superaste el rate limit
500 Internal Server Error	Error del servidor

Formato del error

Los errores devuelven success: false y un mensaje descriptivo:

Respuesta 400

{
  "success": false,
  "message": "name: El campo es obligatorio."
}

En errores de validación, details.issues trae el detalle campo por campo:

Respuesta 400 — varios campos inválidos

{
  "success": false,
  "message": "email: Correo inválido",
  "details": { "issues": [ { "path": ["email"], "message": "Correo inválido" } ] }
}

Buenas prácticas

• Maneja siempre los códigos 4xx y 5xx; no asumas que la petición fue exitosa.
• Ante un 429, respeta el reintento con backoff. Ver rate limits.
• Un 401 suele significar token ausente/revocado; un 403, falta de permiso. Ver autenticación.