Pagination
Most list endpoints are page/limit paginated:page— page number, default1limit— results per page, default20, maximum100
limit above 100 or a page below 1 returns 400 Bad Request. Some endpoints accept extra query parameters (filters such as where, sort, or date ranges); each operation’s parameters are listed in the OpenAPI spec.
Rate limits
Limits are set per route category. They are the same for every workspace and every plan.
MCP write and delete tools have a second limit with the same numbers — 20 writes and 10 deletes per minute — counted per authenticated workspace and user (or per agent key). Both limits apply.
Each response carries an
X-RateLimit-Limit header with the limit of the tier the request fell into. When you exceed a limit you get 429 Too Many Requests with a Retry-After header (in seconds) — see Errors. Wait that long before retrying.
Counters are kept in memory on each API server instance, so the effective limit can be somewhat
higher than the number above when traffic is spread across instances. Do not depend on that
headroom — design your client to stay under the documented numbers.