Response bodies are kept only for idempotent requests

response_data on API request records is now null without an idempotency key

April 22, 2026
Breaking API change

This is a backwards-incompatible change to Buttondown's API. Pinning your newsletter or request to an older API version keeps the previous behavior where a version was cut for it.

API request detail records now retain response_data only for requests that included an X-Idempotency-Key header. See idempotency keys.

This makes the response_data field on GET /v1/api_requests/{id} nullable when no response body was retained. For requests without an idempotency key, response_data will be null.

Buttondown is the last email platform you’ll switch to.