Errores

Los errores de la Client API usan el esquema documentado en la Referencia API. Gestiona siempre el estado HTTP y el code legible por máquina; conserva el mensaje de texto solo para diagnóstico.

{
  "success": false,
  "message": "Assistant not found",
  "requestId": "00000000-0000-4000-8000-000000000000",
  "errors": [{
    "code": "ASSISTANT_NOT_FOUND",
    "message": "Assistant not found"
  }]
}

Estado	Significado	Acción del cliente
400	Entrada no válida	Corrige la solicitud antes de reintentarlo.
401	Credencial ausente o no válida	Verifica la clave del servicio llamado.
404	Recurso inexistente	Verifica el ID y el contexto de la cuenta.
409	El estado actual bloquea la operación	Lee el código y resuelve el conflicto.
429	Límite de Client API alcanzado	Espera Retry-After y vuelve a intentarlo.
5xx	Error del servicio	Reintenta con backoff exponencial limitado.

El servicio Public RAG usa un formato de error propio y más sencillo. Usa únicamente los estados declarados para la operación concreta en la Referencia.