Headers
Every response carries your current standing, so you can pace yourself without guessing:When you go over
You get a429 with code: "RATE_LIMITED". Wait until RateLimit-Reset and retry.
A
429 is the one response that repeats message at the top level, kept for
callers written against the older shape. Read error.code instead.Staying under the limit
Most integrations that hit the limit are making one request per record. Two habits fix that:- Ask for more per page.
pageSizedefaults to 100. Raising it means fewer round-trips for the same data. - Resolve ids in one call. Instead of a
GET /worker/{id}per row, join the table or send onePOST /worker/querywith every id you need. See querying.
PATCH /deliverable/bulk updates every matching record, and one
PUT /deliverable/bulk upserts a whole batch. See
standard endpoints.