Erros e limites

Todo corpo de erro é application/problem+json (RFC 9457): {"type", "title", "status", "detail"}, às vezes com campos extras (invalid, errors).

Status	Significado	O que fazer
400	Validação (detail diz o que está errado; errors lista os campos inválidos) ou accountId ausente quando a credencial alcança várias contas	Corrija o payload; não repita igual.
401	Credencial ausente, malformada, vencida ou revogada	Pare. Peça um token novo ao dono. Nunca repita em loop.
403 citando um escopo	Falta um escopo ao token (detail: The API token lacks the scope 'broadcasts:write'.) ou a rota não está disponível para tokens	Peça um token com esse escopo, ou use outra rota.
403 sem escopo no detail	O recurso é de uma conta que a credencial não pode usar	Confira GET /v1/me.
404	Não existe, ou não é visível para esta conta	Liste de novo antes de concluir que sumiu.
409	Conflito (bot já conectado em outro lugar, execução que não pode ser reprocessada, tarefa já em andamento)	Leia o detail.
429	Acima do limite do token	Espere os segundos de Retry-After e continue.

Limites

• 120 chamadas por minuto por token, em janela fixa de 60 segundos. O contador é por instância da API; não conte com um teto maior atrás do balanceador.
• Janelas do GraphQL: até 365 dias (leadFunnel: 7 dias).
• Listas limitam limit entre 1 e 200 (100 em leads, fluxos e broadcasts).

Novas tentativas

Repetir é seguro em GET. Em escritas, repita só depois de 429 ou de erro de rede, e só depois de confirmar (lendo) que a primeira tentativa não teve efeito. Para 5xx, use backoff exponencial com jitter a partir de 1 segundo.