Codigos HTTP
| Status | Significado | Causa comun |
|---|---|---|
200 | OK | Peticion exitosa |
400 | Bad Request | Parametros faltantes o invalidos |
401 | Unauthorized | API Key no proporcionada o invalida |
403 | Forbidden | Feature no disponible en tu plan |
429 | Too Many Requests | Rate limit alcanzado |
500 | Internal Error | Error del servidor |
Error 401: API Key invalida
X-API-Key tenga una key valida y activa. Puedes crear una nueva en la plataforma.
Error 403: Feature no disponible
Error 429: Rate limit
Retry-After indica cuantos segundos esperar antes de reintentar:
| Plan | Requests/min |
|---|---|
| Starter | 5 |
| Growth | 50 |
| Enterprise | Sin limite |
Manejo recomendado
Errores en streaming (SSE)
Durante un stream, los errores se envian como eventos SSE:error:
Errores comunes
'API key is required'
'API key is required'
No se envio el header
X-API-Key. Asegurate de incluirlo en todas las peticiones.'Invalid API key'
'Invalid API key'
La API Key no corresponde a ningun tenant activo. Verifica que no este revocada y que sea correcta.
'Feature not available in your plan'
'Feature not available in your plan'
Intentaste usar una feature que requiere un plan superior (ej: MCP Servers en plan Starter).
'Rate limit exceeded'
'Rate limit exceeded'
Excediste el limite de requests por minuto de tu plan. Espera el tiempo indicado en
Retry-After.Timeout / Sin respuesta
Timeout / Sin respuesta
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.

