DocumentaciónAPI y MCP
Errores y límites
Los códigos de error, qué significan y cuántas llamadas por minuto.
Un error responde { "error": { "code": "…", "message": "…" } } con su estado HTTP. Por MCP, el mensaje del error de herramienta es CODE: message. Decide según el código, no según el mensaje.
Códigos de error
| Estado | Código | Cuándo |
|---|---|---|
400 | INVALID_INPUT | El cuerpo o un argumento no encaja con la operación: details lista los campos que fallan. |
401 | MISSING_API_KEY, INVALID_API_KEY, EXPIRED_API_KEY, WORKSPACE_DELETED | No hay clave, la clave es desconocida o está revocada, ha caducado, o su espacio se ha eliminado. |
402 | INSUFFICIENT_TOKENS | Una operación de pago que los créditos del espacio no pueden cubrir. |
403 | FORBIDDEN | El creador de la clave no tiene permiso para hacer esto en el espacio: la misma regla que en la aplicación. |
403 | PLAN_LIMIT_EXCEEDED | El plan del espacio no lo incluye: en una cuenta que nunca ha pagado, los enlaces entrantes de un competidor o el análisis de un competidor oculto. |
404 | NOT_FOUND | No existe ese sitio, esa conversación, esa tarea… en este espacio. |
409 | CONFLICT | Ya está en curso, o en un estado que no lo permite. |
429 | RATE_LIMITED | Demasiadas peticiones para el espacio: Retry-After indica cuándo volver a intentarlo. |
503 | SERVICE_UNAVAILABLE | Un servicio que necesita la operación no está disponible por un momento: vuelve a intentarlo más tarde. |
500 | INTERNAL_ERROR | Es culpa nuestra: vuelve a intentarlo más tarde. |
402
{
"error": {
"code": "INSUFFICIENT_TOKENS",
"message": "Workspace is out of tokens for this period."
}
}Límites de uso
| Por espacio | |
|---|---|
| API | 120 peticiones por minuto |
| MCP | 30 llamadas a herramientas por minuto |
Por encima del límite, la respuesta es 429 RATE_LIMITED, con una cabecera Retry-After que indica cuándo volver a intentarlo.
¿No encuentras la respuesta? Escríbenos.

