Skip to main content
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. The errors array names each offending field with a machine-readable code.

Likely causes

  • limit above 200 or offset above 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 an Idempotency-Key header over 200 characters.

What to do

Read the errors array, fix each named field, and resend. Do not build retry loops around 400s — the same request always produces the same 400.