502 · response_too_large

response_too_large: the target returned more than the relay accepts

response_too_large means the upstream answered, but the body exceeded the per-call allowance, so the relay could not hand it back as a single envelope. The attempt reached the network and is charged as a trip.

Common causes

  • An endpoint that returns a full collection instead of a page.
  • A download endpoint returning a file rather than metadata.
  • An error path that dumps a large HTML page instead of a short JSON error.

How to fix it

  1. 01Ask the upstream for a page or a filtered result set.
  2. 02Request only the fields you need with the target API's own parameters.
  3. 03For genuine file downloads, fetch metadata here and stream the artefact from your own storage.

What it looks like

response_too_large
# ask for a page instead of the whole collection
{
  "url": "https://api.example.com/v1/items?limit=50&fields=id,name",
  "method": "GET",
  "timeout_ms": 10000
}

Every error code

Questions about this

Related errors

Try it with 5,000 free trips.

No card, no subscription, and the balance never expires.