Quick Summary: The request could not be accepted as written — a parameter is out of range, a field is unknown, or a value has the wrong shape. Fix the request; retrying unchanged will fail again.
What happened
The API rejected the request before doing any work. Theerrors array names each offending field with a machine-readable code.
Likely causes
limitabove 200 oroffsetabove 10,000 — the API rejects these rather than silently clamping.- A filter or sort field that is not on the endpoint whitelist (
not_filterable/not_sortable). - An unknown body or query member — including any attempt to pass
companyId; tenancy always comes from your key. - A malformed id (
invalid_id), or anIdempotency-Keyheader over 200 characters.
What to do
Read theerrors array, fix each named field, and resend. Do not build retry loops around 400s — the same request always produces the same 400.