DocumentationAPI & MCP
Erreurs et limites
Les codes d'erreur, ce qu'ils veulent dire, et combien d'appels par minute.
Une erreur répond { "error": { "code": "…", "message": "…" } } avec son statut HTTP. Via MCP, le message de l'erreur d'outil est CODE: message. Fiez-vous au code, pas au message.
Codes d'erreur
| Statut | Code | Quand |
|---|---|---|
400 | INVALID_INPUT | Le corps ou un argument ne correspond pas à l'opération : details liste les champs en cause. |
401 | MISSING_API_KEY, INVALID_API_KEY, EXPIRED_API_KEY, WORKSPACE_DELETED | Pas de clé, une clé inconnue ou révoquée, une clé expirée, ou son espace a été supprimé. |
402 | INSUFFICIENT_TOKENS | Une opération facturée, que les crédits de l'espace ne peuvent pas payer. |
403 | FORBIDDEN | Le créateur de la clé n'a pas le droit de faire cela dans l'espace : la même règle que dans l'app. |
403 | PLAN_LIMIT_EXCEEDED | Le plan de l'espace ne le comprend pas : sur un compte qui n'a jamais payé, les liens entrants d'un concurrent ou l'analyse d'un concurrent masqué. |
404 | NOT_FOUND | Ce site, cette conversation, cette tâche… n'existe pas dans cet espace. |
409 | CONFLICT | Déjà en cours, ou dans un état qui l'interdit. |
429 | RATE_LIMITED | Trop de requêtes pour l'espace : Retry-After indique quand réessayer. |
503 | SERVICE_UNAVAILABLE | Un service dont l'opération a besoin est brièvement indisponible : réessayez plus tard. |
500 | INTERNAL_ERROR | Une erreur de notre côté : réessayez plus tard. |
402
{
"error": {
"code": "INSUFFICIENT_TOKENS",
"message": "Workspace is out of tokens for this period."
}
}Limites de débit
| Par espace | |
|---|---|
| API | 120 requêtes par minute |
| MCP | 30 appels d'outils par minute |
Au-delà de la limite, la réponse est 429 RATE_LIMITED, avec un en-tête Retry-After qui indique quand réessayer.
Une question sans réponse ici ? Écrivez-nous.

