Orders API will limit POST message body size to one megabyte

On 2025-05-12, the orders API will restrict the size of POST request message body parameters to 1 megabyte (1 MB). On 2025-05-12, if you include more than 1 MB in the message body of a POST request, the orders API will return an HTTP 400 error response.

This change affects all orders API endpoints that accept a message body parameter. For example, the change affects the following endpoints:

• POST /orders (creating orders)

• POST /prices (getting prices for orders)

The orders API already restricts Order objects in POST requests to 1000 top-level Selection objects. The new message body size restriction is in addition to the 1000 selection limit.

The orders API message body size restriction is currently in effect for the Toast API sandbox environment. You can test your orders API integration to make sure that the message body parameters for POST requests do not exceed 1 MB before the restriction is enforced in the production environment on 2025-05-12.