Limites e planos

Orçamento e taxa

Um limite é definido por par (integração, workspace) — não por chave e não pela organização inteira. É esse recorte que permite dar um teto ao time de suporte sem mexer no do time de produto, mesmo os dois usando o mesmo provedor.

• Orçamento estourado recusa 403 budget_esgotado.
• Taxa estourada recusa 429 rate_limite_excedido. Um 429 do provedor é repassado com o corpo dele — olhe x-origem-da-falha para distinguir os dois.
• Um limite é imutável depois de criado: para mudar um teto, crie o novo e apague o velho. É o que mantém a trilha honesta sobre qual teto valia em cada momento.

Planos e retenção de linha

O plano da organização decide por quanto tempo a linha da trilha sobrevive. É uma alavanca comercial, não de conformidade — a retenção do conteúdo (o que fica gravado dentro da linha) é independente, configurada pela própria organização, e está descrita em Observabilidade.

Toda organização nasce em sandbox, e sandbox foi escolhido para não expirar nada: perder trilha por default seria o pior comportamento possível para quem está avaliando a plataforma. O plano é somente leitura no console — mudá-lo é provisionamento, não uma configuração de tela.

Tetos que valem para todo mundo

• Corpo de requisição acima de 1 MiB recusa 413 — requisicao_invalida no data plane, corpo_grande_demais no gateway MCP e no gateway A2A.
• Notificação entrante de agente (POST /a2a/webhook/{token}): teto próprio e menor, 256 KiB — acima disso, 413 notificacao_grande_demais. Essa rota também tem teto por IP por minuto, com 429 rate_limit.
• input de embeddings: no máximo 2048 itens, o mesmo teto da OpenAI.
• A rota pública GET /v1/openapi.json tem teto por IP; estourado, responde 429 rate_limit. Guarde o documento em cache em vez de buscá-lo a cada render.

Exclusão da organização

Pedida a exclusão, a organização entra numa janela até a data agendada. Durante ela, o data plane recusa 403 org_em_exclusao, e o corpo traz agendadaEm — dá para cancelar no console antes da data.