DocumentaçãoAPI e MCP
Erros e limites
Os códigos de erro, o que eles significam e quantas chamadas por minuto.
Um erro responde { "error": { "code": "…", "message": "…" } } com o status HTTP dele. Pelo MCP, a mensagem do erro da ferramenta é CODE: message. Use o código para decidir, não a mensagem.
Códigos de erro
| Status | Código | Quando |
|---|---|---|
400 | INVALID_INPUT | O corpo ou um argumento não corresponde à operação: details lista os campos com problema. |
401 | MISSING_API_KEY, INVALID_API_KEY, EXPIRED_API_KEY, WORKSPACE_DELETED | Sem chave, uma chave desconhecida ou revogada, uma chave expirada, ou o espaço de trabalho dela foi excluído. |
402 | INSUFFICIENT_TOKENS | Uma operação cobrada, e os créditos do espaço de trabalho não conseguem pagá-la. |
403 | FORBIDDEN | Quem criou a chave não tem permissão para fazer isso no espaço de trabalho: a mesma regra do aplicativo. |
403 | PLAN_LIMIT_EXCEEDED | O plano do espaço de trabalho não inclui isso: em uma conta que nunca pagou, os backlinks de um concorrente ou a análise de um concorrente oculto. |
404 | NOT_FOUND | Esse site, conversa, tarefa… não existe neste espaço de trabalho. |
409 | CONFLICT | Já está em andamento, ou em um estado que não permite isso. |
429 | RATE_LIMITED | Requisições demais para o espaço de trabalho: Retry-After diz quando tentar de novo. |
503 | SERVICE_UNAVAILABLE | Um serviço de que a operação precisa está indisponível no momento: tente mais tarde. |
500 | INTERNAL_ERROR | A culpa é nossa: tente mais tarde. |
402
{
"error": {
"code": "INSUFFICIENT_TOKENS",
"message": "Workspace is out of tokens for this period."
}
}Limites de requisições
| Por espaço de trabalho | |
|---|---|
| API | 120 requisições por minuto |
| MCP | 30 chamadas de ferramentas por minuto |
Acima do limite, a resposta é 429 RATE_LIMITED, com um cabeçalho Retry-After que diz quando tentar de novo.
Não encontrou a resposta? Fale com a gente.

