Skip to main content

Codigos HTTP

Error 401: API Key invalida

Solucion: Verifica que el header X-API-Key tenga una key valida y activa. Puedes crear una nueva en la plataforma.

Error 403: Feature no disponible

Solucion: Algunas features solo estan disponibles en planes superiores. Revisa los planes o contacta ventas para un upgrade.

Error 429: Rate limit

El header Retry-After indica cuantos segundos esperar antes de reintentar:
Limites por plan:

Manejo recomendado

Errores en streaming (SSE)

Durante un stream, los errores se envian como eventos SSE:
El widget maneja estos errores automaticamente. Si usas la API directamente, escucha el evento error:

Errores comunes

No se envio el header X-API-Key. Asegurate de incluirlo en todas las peticiones.
La API Key no corresponde a ningun tenant activo. Verifica que no este revocada y que sea correcta.
Intentaste usar una feature que requiere un plan superior (ej: MCP Servers en plan Starter).
Excediste el limite de requests por minuto de tu plan. Espera el tiempo indicado en Retry-After.
El agente puede tardar mas si ejecuta multiples tools. El timeout default es de 60 segundos. Si usas tools HTTP lentas, considera optimizar tus endpoints.