Rate limits

Limites de requisições por workspace em cada plano, janelas separadas para decisões e leituras, os headers X-RateLimit em toda chamada, Retry-After no 429 e como fazer backoff.

A API pública limita quantas requisições um workspace pode fazer por minuto. O limite vem do plano do workspace:

PlanoRequisições por minuto
Genesis60
Developer300
Growth2.000
Enterprise10.000

A página API Keys do app mostra o seu limite atual, e GET /v1/me o devolve como plan.rate_limit_per_minute.

Como o limite é contado

  • Por workspace, não por chave. Todas as API keys de um workspace compartilham um único orçamento; criar mais chaves não aumenta a capacidade.
  • Decisões e leituras têm janelas separadas. POST /v1/decisions/{slug} conta numa janela; os endpoints de leitura, GET /v1/decisions, GET /v1/me e GET /v1/executions, em outra com o mesmo limite por minuto — então fazer polling neles nunca desacelera as suas decisões. Chamadas à URL de webhook de uma decisão têm uma terceira janela própria (mesmo limite, compartilhada pelos webhooks do workspace), então uma URL vazada não consegue desacelerar as suas API keys. Toda requisição ao servidor MCP (initialize, tools/list, qualquer chamada de ferramenta) conta com as leituras, e run_decision também conta com as decisões. Chamadas de webhook com assinatura ou segredo errados não tocam nessas janelas: elas têm um orçamento próprio de 30 por minuto por webhook (depois, 429).
  • Sub-workspaces compartilham as janelas do pai. No modo parceiro, chamadas com o header Dcision-Workspace contam nas janelas do seu workspace, qualquer que seja o cliente.
  • Janelas fixas de um minuto. Uma janela abre com a primeira requisição e dura 60 segundos; a próxima requisição depois disso abre uma nova.
  • Toda requisição autenticada conta — chamadas bem-sucedidas, erros e repetições idempotentes. Requisições com uma chave inválida são rejeitadas antes do limite e não contam.

Headers

Toda resposta autenticada traz o estado da sua janela — a janela de decisões ou a de leituras:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 12
X-RateLimit-Reset: 1791195060
HeaderDescrição
X-RateLimit-LimitRequisições permitidas por janela para o seu workspace.
X-RateLimit-RemainingRequisições restantes na janela atual.
X-RateLimit-ResetQuando a janela atual termina, em segundos Unix.

Quando você atinge o limite

HTTP/1.1 429 Too Many Requests
Retry-After: 23
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 1791195060
{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Slow down and retry after the reset time.",
    "request_id": "req_Tz6Kq1mW8vLp3Xc9Rn4D"
  }
}

Espere Retry-After segundos e repita. Requisições enviadas antes disso continuam falhando — e continuam contando.

async function decide(slug, state) {
  for (let attempt = 0; attempt < 3; attempt++) {
    const response = await fetch(`https://api.dcision.io/v1/decisions/${slug}`, {
      method: "POST",
      headers: { Authorization: `Bearer ${process.env.DCISION_API_KEY}`, "Content-Type": "application/json" },
      body: JSON.stringify({ state }),
    });
    if (response.status !== 429) return response;
    const wait = Number(response.headers.get("Retry-After") ?? "1");
    await new Promise((resolve) => setTimeout(resolve, wait * 1000));
  }
  throw new Error("Still rate limited after 3 attempts");
}

Ficando abaixo do limite

  • Acompanhe X-RateLimit-Remaining e desacelere antes que chegue a 0.
  • Suavize picos com uma fila ou um token bucket do seu lado, em vez de enviá-los todos de uma vez.
  • Não espalhe a carga entre mais chaves — elas compartilham o orçamento do workspace.
  • Precisa de mais? Faça upgrade do seu plano, ou fale com sales@dcision.io sobre o Enterprise.

Limites do Playground

As execuções no Playground têm um teto próprio, separado da API: 30 execuções por minuto e 2.000 execuções por dia por workspace. Acima disso, o Playground responde 429 RATE_LIMITED; use uma API key para volume.

Vazão do engine

O provedor do engine tem limites próprios, em requisições e tokens por segundo. Na chave de engine da Dcision, eles são compartilhados por todos os workspaces, então a Dcision suaviza os picos: uma decisão espera por uma vaga livre dentro do seu timeoutMs em vez de falhar na hora. Se nenhuma vaga se liberar a tempo, a chamada falha com 503 ENGINE_RATE_LIMITED — um erro de engine, que pode ser repetido com backoff, e não o 429 RATE_LIMITED do seu workspace. Com a sua própria chave de provedor, valem os limites da sua conta no provedor. Veja Engines e BYOK.

Nesta página