429 Too Many Requests.
Runs at the same time
A run counts while it isqueued or running. A run paused at awaiting_input does not count. The limits apply per person and per organization.
The runs of an API key count against the person who created the key. Changing name or email on POST /chat does not change the count.
SaaS
Free has no API keys, but its limit still applies to the web app. See Plans and limits for the rest of each plan.
Enterprise
By default, 10 runs per person and 25 per organization. Your deployment can set other values, and an Admin can give one member a different per-person limit withPUT /admin/concurrency/members/{user_id} and the body {"max_concurrent_agent_runs": 15} (a key needs Admin). Sending null or 0 removes the member’s own limit, and the default applies again.
Past the limit
POST /chat answers 429 with a Retry-After header of 30 seconds. On SaaS, resuming a paused run takes a place again, so POST /runs/{run_id}/resume can answer the same 429.
Workflow runs at the same time
Workflow runs have a limit of their own, counted separately from the agent runs ofPOST /chat:
- Enterprise: 25 workflow runs in progress per organization, by default.
- SaaS: the plan’s runs at a time from the table above: the organization’s limit for an organization, the person’s for a personal account.
429 with Retry-After: 30 and You already have N workflow runs in progress (limit N). Please wait for one to finish and try again shortly.
Requests per minute
These requests are counted per minute, in fixed one-minute windows. An API key has its own count, separate from the web app traffic of the person who made it.
These are the defaults; a deployment can change them. Past a limit you get
429 with Retry-After set to the seconds left in the current minute, and a body like this:
scope names the limit: workflow_runs, workflow_compile or agent_compile.
Runs started per hour
A deployment can also limit how many runs an organization starts per hour. This limit is off by default. When it is on and reached,POST /chat answers 429 with Retry-After: 300 and Your organization has started N agent runs in the last hour (limit N). Please wait before starting more.
Usage and spend limits
A429 can also mean the usage you may spend is used up, or a spend limit is reached. Those answers have no Retry-After, because waiting a few seconds does not clear them. The messages are on Errors.
Handle a 429
- If the answer has
Retry-After, wait that many seconds before you retry. - For a run limit, you can also wait for one of your runs to end. Poll or stream it, or use a webhook.
- Retry with the same
idempotency_key, so a retry never starts a second run. - If there is no
Retry-After, do not retry in a loop. Readdetail: an Admin has to act, for example by buying a top-up or raising a limit.
chat_ids) within these limits. A conversation runs one turn at a time.