Limite de requisições

Os limites protegem a plataforma e a experiência nos apps. Eles valem por conta, independentemente de quantas chaves, conexões OAuth ou agentes você use.

A janela é o minuto corrente do relógio do servidor e é compartilhada entre todas as instâncias.

Ao exceder o limiteCopiar link da seção

HTTP/1.1 429 Too Many Requests
Retry-After: 60
Content-Type: application/json

{
  "error": {
    "code": "rate_limited",
    "message": "Muitas solicitações. Aguarde um minuto e tente novamente.",
    "details": { "retryAfter": 60 }
  }
}

Aguarde os segundos indicados em Retry-After antes de repetir. Um laço de novas tentativas imediatas só prolonga o bloqueio.

async function withRetry(call: () => Promise<Response>) {
  const response = await call();
  if (response.status !== 429) return response;
  const seconds = Number(response.headers.get("Retry-After") ?? 60);
  await new Promise((resolve) => setTimeout(resolve, seconds * 1000));
  return call();
}

Outros limitesCopiar link da seção

• Corpo da requisição: 1 MB.
• Ações de gerenciamento de webhooks (cadastro, teste, rotação de segredo e reenvio): 5 por minuto, cada uma.

Veja todos os limites em Limites de uso.