Limits and error codes

The hard numbers that do not depend on the plan — file size, images, tools, rounds, rate limits — and the error codes you may meet.

Fixed limits

What	Limit
Document upload	25 MB per file; pdf, docx, txt, md, html, htm, csv, tsv, json, eml
Images in Chat / Run	6 images per turn, 10 MB each; png, jpeg, webp, gif
Chunk size	64 – 2048 tokens (default 512); overlap 0 – 50 % (default 15)
Keywords / Questions per passage	0 – 10 / 0 – 5
Passages per answer	3 – 20 (default 6)
Tools on one agent	8
Maximum rounds	1 – 10
Memories recalled per run	1 – 20
Origins per widget	1 – 20
Versions compared at once	2 – 4
Error policy go to	up to 4 targets
Custom top-up	$10 – $2,000

Action	Limit
Sign-in / wrong password	20 per 5 minutes per IP
Chat questions	30 / minute per person
Agent runs	20 / minute per person
Speech (STT/TTS)	30 / minute
Developer API (API key)	120 / minute per key
Inbound webhooks (`/v1/hooks`)	60 / minute per IP
Embedded chat widget	60 / minute per IP; plus the widget's Messages per visitor per hour

Over the limit the response is 429 with a Retry-After header.

Every error has the shape { error: { code, message }, requestId }. Quote the requestId when contacting support.

HTTP	Code	Meaning
401	`UNAUTHORIZED`	Not signed in or the session expired.
402	`INSUFFICIENT_CREDITS`	Out of credits — top up.
402	`PLAN_LIMIT_REACHED`	Hit the plan's knowledge base / agent / widget count.
402	`PLAN_FEATURE_UNAVAILABLE`	Feature not in the plan (API keys, data sources, webhooks/triggers, top-ups).
402	`SEAT_LIMIT_REACHED`	No seats left (members + pending invitations).
403	`FORBIDDEN`	Signed in but missing the permission.
404	`NOT_FOUND`	Does not exist — or exists and you may not see it.
409	`CONFLICT`	Duplicate (a slug already in use, say).
422	`VALIDATION_ERROR`	Malformed input; `details` names the field.
429	`RATE_LIMITED`	Rate limit exceeded.
500	`INTERNAL_ERROR`	Server-side failure — retry, then send the `requestId`.