# payload_too_large

> 413 Payload too large. The request is bigger than the endpoint takes.

| Status                | Code                | Retry?          |
| --------------------- | ------------------- | --------------- |
| 413 Payload too large | `payload_too_large` | After fixing it |

## 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

The answer, `413`:

```json
{
  "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](https://usebluebot.com/docs/errors): the envelope and every code
- [Idempotency](https://usebluebot.com/docs/concepts/idempotency): retrying without sending twice
- [Limits](https://usebluebot.com/docs/limits): every cap and what happens when you reach it