Failures and limits
What arrives instead of an answer, and what to do about it.
A failure comes in one shape: a machine code and a line for a human.
429 { "error": { "code": "rateLimited", "message": "at most 120 requests a minute" } }Codes
- unauthorized401
- The token expired or the consent was revoked
- forbidden403
- The scope is not granted
- notFound404
- No such row — or it is not visible to the member whose consent opened the door
- conflict409
- The state of the conversation does not allow it: nobody to write to, or the channel is offline
- rateLimited429
- Too often
- badRequest400
- A field is missing or has the wrong shape
Limits
A hundred and twenty requests a minute per consent; a refusal carries Retry-After. A page returns fifty rows, or up to two hundred if you ask.