Limites
Todos os limites de tamanho e de quantidade num só lugar — corpo da requisição, estado e orçamento de tokens, decision schema, destinos e entregas, identificadores, workspace, time e login.
Requisições de API
| Limite | Valor | Quando excedido |
|---|---|---|
| Corpo da requisição | 128 KB | 413 PAYLOAD_TOO_LARGE — "Request body is too large." |
| Corpo de requisição que carrega um decision schema | 1 MB — POST /mcp (validate_schema, create_decision, update_decision) e o editor do app. O estado dentro dele continua limitado a 128 KB | 413 PAYLOAD_TOO_LARGE — "Request body is too large." |
| Corpo da requisição de uma execução | 32 MB — POST /v1/decisions/{slug}, o Playground e POST /v1/hooks/{token} (JSON, texto ou multipart/form-data), para que o estado possa carregar arquivos | 413 PAYLOAD_TOO_LARGE — "Request body is too large." |
Arquivos num estado (campos image, audio, file) | 20 MB cada, 24 MB e 10 arquivos no total; o texto deles é cortado em cerca de 96.000 caracteres no total | 422 INVALID_STATE — "Field invoice is too large (…)" |
| Estado serializado (sem os arquivos) | 128 KB e cerca de 32.000 tokens (caracteres ÷ 4, ou seja, cerca de 128.000 caracteres de JSON) | 422 INVALID_STATE — "Field state is too large (…)" |
| Orçamento de tokens por chamada | cerca de 32.000 tokens para o estado mais a pergunta mais longa, 64.000 para o estado mais todas as perguntas | 422 INVALID_STATE — "The state plus … is too large …" |
| Itens num estado em lista | 1 a 500 | 422 INVALID_STATE — "Field state has too many items (…)" |
| Requisições por minuto | 60 / 300 / 2.000 / 10.000 conforme o plano, por workspace — decisões e leituras (GET /v1/decisions, /v1/me, /v1/executions) contadas separadamente | 429 RATE_LIMITED — veja Rate limits |
| Volume incluído | 1M por mês no Genesis, mais nos planos pagos; além disso, as decisões são pagas com créditos pré-pagos, até o teto de gastos opcional por ciclo de cobrança | 402 CREDITS_EXHAUSTED sem créditos, 402 SPEND_CAP_REACHED no teto de gastos — 402 QUOTA_EXCEEDED num plano com limite rígido. Veja Planos |
| Prazo do engine | o timeoutMs da decisão: 5.000 ms por padrão, de 500 a 30.000, retries incluídos | 504 ENGINE_TIMEOUT |
Tamanho da página de GET /v1/executions | 1 a 100, padrão 20 | 400 INVALID_REQUEST |
Idempotency-Key | 1–128 caracteres de A–Z a–z 0–9 . _ : - | 400 INVALID_REQUEST |
X-Request-ID | 1–128 caracteres do mesmo conjunto | Substituído por um ID req_… gerado (sem erro) |
| Replays idempotentes | 24 horas | Tratada como uma nova requisição |
Os tokens são estimados como caracteres ÷ 4 do JSON serializado. O orçamento de tokens é o do Jev: as perguntas contam com as suas instruções, opções, níveis e critérios.
Decision schema
| Item | Limite |
|---|---|
| Perguntas por decisão | 1 a 64 |
| Regras de política por decisão | até 50 |
| Condições AND extras por regra | até 5 |
| Composites por decisão | até 20 |
| Termos por composite | 1 a 20 |
| Peso de um termo de composite | −100 a 100, diferente de 0 |
| Campos do estado (estado de objeto) | até 50 |
| Itens num estado em lista | 1 a 500 |
| Opções por pergunta de escolha | 2 a 254, mais other |
| Níveis por pergunta de nota | 2 a 10 |
| Instruções | 1 a 8.000 caracteres |
context | até 8.000 caracteres |
| Descrição de opção, nível de nota, critério de probabilidade | até 2.000 caracteres |
| Descrição de campo do estado | até 255 caracteres |
Valor string de política, label de nível estruturado | até 255 caracteres |
| Descrição de composite | até 500 caracteres |
| Chaves (campos, perguntas, composites, valores de opção) | snake_case, até 48 caracteres |
minConfidence | 0 a 1 |
timeoutMs | 500 a 30.000 |
| Schema inteiro, serializado | até 1 MB (o corpo que o carrega) |
Instruções, descrições de opções, níveis de nota e critérios podem ser texto ou JSON; o JSON é medido pelo seu tamanho serializado. Veja Decision schema.
Decisões
| Item | Limite |
|---|---|
| Nome | 1 a 80 caracteres |
| Descrição | até 500 caracteres |
| Slug | até 64 caracteres: letras minúsculas, dígitos e hifens simples; travado depois do primeiro deploy |
| Decisões por workspace | Genesis 2, Developer 10, Growth e Enterprise ilimitadas (402 PLAN_LIMIT_REACHED) |
Workspace
| Item | Limite |
|---|---|
| API keys ativas | 50 por workspace (409 CONFLICT — revogue antes uma chave sem uso) |
| Nome da API key | 1 a 80 caracteres |
| Chave de provedor (BYOK) | 8 a 512 caracteres |
| Retenção do log de execuções | Genesis 7, Developer 14, Growth 30, Enterprise 365 dias — ou menos, conforme a configuração do workspace |
| Playground | 30 execuções por minuto e 2.000 por dia |
| Códigos de login | 6 dígitos, válidos por 10 minutos, 5 tentativas, 3 códigos por e-mail a cada 10 minutos e 10 por dia |
| Login com senha | 5 tentativas erradas por e-mail, depois uma espera de 15 minutos |
| Senha | 10 a 128 caracteres, letras e números |
Time
| Item | Limite |
|---|---|
| Workspaces dos quais você é owner | 10 (409 CONFLICT) |
| Convites | válidos por 7 dias; 30 por hora por workspace e por pessoa (429 RATE_LIMITED) |
| Convites pendentes | 50 por workspace (409 CONFLICT) |
Veja Time, papéis e conta.
Destinos
| Limite | Valor |
|---|---|
| Destinos por decisão | 20 |
| Destinos disparados por execução | 10 |
Respostas de LLM e agentes sync por execução | 3 |
| Condições por destino | 5 |
| Parâmetros por destino | 30 |
| Valor fixo de parâmetro | até 500 caracteres |
| Headers por destino | 20 |
| Valor de header | até 2.048 caracteres |
| URL | até 2.048 caracteres |
Template do corpo de http | até 10.000 caracteres |
| Descrição do destino | até 2.000 caracteres |
| Texto da resposta | até 4.000 caracteres |
| Botões da resposta | até 10, com até 80 caracteres cada |
Prompt e entrada de LLM, instructions e input de saída estruturada | até 8.000 caracteres cada |
| Instruções de agente | até 32.000 caracteres |
| Ferramentas de agente | até 50 |
Timeout de LLM e de agente sync | 1.000 a 25.000 ms, padrão 20.000 |
maxTokens de LLM | 16 a 2.048, padrão 512 |
temperature de LLM | 0 a 2, padrão 0,3 |
Resposta do agente devolvida em response | até 16.000 caracteres |
| Tentativas de entrega | 6, ao longo de cerca de 7 horas |
| Timeout de cada tentativa de entrega | 10 segundos |
| Entregas por workspace | 600 por minuto |
| Retenção de entregas | 30 dias |
| Segredos do workspace | 50, com valores de até 4.096 caracteres |
Além desses limites, um destino que combina é ignorado com "reason": "limit", e um destino inválido torna o schema inválido (422 INVALID_SCHEMA). Veja Segurança e limites dos destinos.
Idempotência
Faça retries com segurança usando o header Idempotency-Key — chaves reservadas antes da execução, replays de chamadas bem-sucedidas por 24 horas, o header Idempotent-Replayed e IDEMPOTENCY_CONFLICT.
Visão geral dos SDKs
Os SDKs oficiais de TypeScript e Python — o que eles acrescentam ao HTTPS puro, como se comparam e como compilá-los do código-fonte até serem publicados no npm e no PyPI.