payload_too_large

HTTP 413

When you see this

Every /api/v1/* request body is limited to 8,192 bytes (8 KB). Canopy rejects the request before it runs if the body is larger.

Canopy checks both the Content-Length header and the bytes it actually receives. A missing or wrong Content-Length does not let a larger body through.

What the response looks like

{
  "error": {
    "code": "payload_too_large",
    "message": "The request body is too large.",
    "request_id": "req_1a2b3c4d5e6f7a8b9c0d1e2f",
    "docs": "https://canopypay.io/errors/payload_too_large"
  }
}

What to do

Make the request body smaller. Usually this means trimming a large metadata object on POST /api/v1/intents. Fix this on your side. Retrying the same body fails the same way. The limit is the same for every caller and cannot be raised per request.