Chaves e contas
Minha chave parou de funcionar
Diagnostique respostas 401 e 403 em chamadas autenticadas com chave.
401 invalid_token
A mensagem indica a causa:
| Mensagem | Causa provável |
|---|---|
| "A chave expirou, foi revogada ou é inválida." | A validade (7, 30 ou 90 dias) terminou ou a chave foi revogada. |
| "A chave é inválida para esta conexão." | Chave de API usada no MCP, ou chave MCP usada na API. Ou a chave foi copiada incompleta. |
| "Envie uma credencial Bearer válida." | O header não segue o formato Authorization: Bearer <chave>. |
Sem o header Authorization, a API responde 401 unauthorized ("Entre na sua conta para continuar.") e o MCP pede para conectar por OAuth ou usar uma chave MCP.
Confira a situação da chave em Integrações. Chaves expiradas não podem ser renovadas: crie uma nova.
403 insufficient_scope
A chave é válida, mas não tem a permissão exigida. O escopo necessário vem em error.details.scope:
{
"error": {
"code": "insufficient_scope",
"message": "Esta conexão não tem permissão para a ação.",
"details": { "scope": "scripts:write" }
}
}Os escopos de uma chave não podem ser alterados depois da criação. Crie uma nova chave com leitura e escrita.
403 em outras ações
Gerenciar chaves, webhooks e dados da conta exige a sessão web. Chaves recebem 403 nessas rotas por segurança.