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 un cuerpo JSON con un mensaje descriptivo:

Respuesta 400

{
  "error": "ValidationError",
  "message": "El campo 'name' es obligatorio."
}

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.