# body_too_large

The request body is larger than the server reads (413).

## Meaning

Written before the handler runs: the body exceeds `server.http.max_body_bytes`
(default 262144 bytes, 256 KiB) or the operation's own bound.

## Impact

The request did nothing. Legitimate requests are far smaller; a large body is a
client bug or an attempt to exhaust memory.

## Diagnosis

The refusal is recorded as `http.request.screened` with reason `invalid_request` and
cause `body_too_large`. Compare the client's `Content-Length` with the configured
bound.

## Mitigation

- As a client developer: send a smaller body; do not retry the same one.
- As an operator: raise `server.http.max_body_bytes` only for a known, legitimate
  need.

## Escalation

Escalate when a body well under the bound is refused. Open an issue with the request
id, the body size and the server version.

---

[Problem code runbooks](https://www.nauthera.io/docs/v1/runbooks/problems) · Generated from [`internal/runbook/problems.yaml`](https://github.com/nauthera/nauthera-server/blob/main/internal/runbook/problems.yaml) in nauthera-server.