Will Terra retry or chunk a 413 payload for me?

Terra does not retry with a smaller payload after a 413.

Terra does not retry with a smaller payload after a 413.

There is no fixed size limit on a single webhook (long activities can be tens of MB). Automatic chunking only triggers when an API request spans more than one calendar month: a within-month range (for example Dec 1 to Dec 31) is never split regardless of size, and can exceed your host's request limit.

To force splitting, use a range that crosses a month boundary (for example Dec 1 to Jan 31). Each chunk is then capped around 10MB and all chunks share the same terra-reference header. See the documented limits in setting up webhook destinations.

To handle large payloads reliably:

• raise the body-size limit on your webhook server and any proxy/ingress in front of it

• narrow the date range per request

• enable the PING / s3_payload mechanism that sends a short-lived URL you GET to retrieve the full payload