Add items to an order

POST 
/v1/orders/:id/combos

Adds one or more items to an existing order and returns the order with its totals recalculated. Send every item in a single call: totals are recalculated once for the whole batch.

Every item references an existing product variant in your menu by variant_id, and every modifier references an existing modifier by modifier_id. OlaClick resolves the product, name, prices and kitchen from the menu; you never send them. An id that does not exist, or that belongs to another company, is rejected with 422.

A modifier quantity is per unit of the item: one large side on an item with quantity: 2 records two large sides.

Only orders created through the API can be changed here. An order taken on the storefront, the POS or a food app belongs to that channel and answers 422 order_not_modifiable.

Required scope: orders:write

Request

Responses

201

The order with the items added.

401

Unauthenticated — the request is missing a credential, or the Bearer token / API key is invalid, expired, or revoked.

403

Insufficient scope — the credential is authenticated but lacks a scope the endpoint requires.

404

Not found — no resource matches the id in the path (or it belongs to a different company).

422

Validation failed — the request body failed schema validation. errors[] lists every offending field.