payload_too_large

What it means

The request is bigger than the endpoint takes.

Common causes

• A file over 25 MB.
• A JSON body over 1 MB.
• Text over 2000 characters.

What to do

Send less. The docs list each size limit.

Can I retry it?

Only after you fix what the message names. Until then the same request gets the same answer.

What the answer looks like

{
  "error": {
    "code": "payload_too_large",
    "message": "Files can be up to 25 MB.",
    "hint": "Send less. The docs list each size limit.",
    "doc_url": "https://usebluebot.com/docs/errors/payload_too_large",
    "request_id": "req_1Hq2LxW9cVbN3mKpRtYs0a"
  }
}

Branch on code, which never changes. message and hint are written for people and may be reworded. Quote request_id when you write to support.

Related

• Errors: the envelope and every code
• Idempotency: retrying without sending twice
• Limits: every cap and what happens when you reach it