Group Cart Update

Changes the order type, its properties or the modifications deadline. Host only, and the store cannot be changed — start a new session for a different store.

While the session is open you can change either. Once it is locked you can still change the order type right up until payment is initialized, which is how a host switches from ASAP to a scheduled time at checkout, but the deadline is then fixed and returns 1206.

Changing anything here invalidates a checkout you have already performed, so check out again before paying.

Path Parameters

group_cart_uuid
Type: stringFormat: uuid
required

UUID of the group cart session

Headers

Application
Type: string
required

White Label Application Key
Api-Version
Type: string
required

Version of the API that the client app expects
Content-Type
Type: string
required

Required even on requests with no body
Authorization
Type: string
required

Bearer token of the signed-in customer
Dlc-Authorization
Type: string

Punchh customer token, on a brand integrated with Punchh. Authorization does not authenticate you to Punchh. Send it on every cart call for a signed-in registered customer — any cart with items triggers a loyalty calculation, with or without a discount — and for a guest only when the cart carries a reward, offer, credit or promo code. Omitting it falls back to the token stored for that customer at sign-in, which may be stale.

Declared optional because it is conditional, not because it is safe to leave out. It applies only to a Punchh brand, so marking it required would be wrong for every brand without the integration. See Use Rewards, Offers, Customer Credits, and Promo Codes.

Body

required

application/json

Send at least one of the two.

modifications_deadline_at
Type: string | nullFormat: date-time

Send null to clear the deadline.
order_type
Type: object
Properties: 6

Responses

200

The updated session.
400

1204 not the host · 1206 the session state does not allow this change · 1214 group ordering is not enabled for the new order type
404

Unknown group cart.
422

Validation failed.

patch/group-cart/{group_cart_uuid}

curl https://api-public-demo.menu.app/api/group-cart/7c9e6679-f1e4-40b3-a2c5-e8f1a0b9d4c3 \
  --request PATCH \
  --header 'Application: ' \
  --header 'Api-Version: 4.78.0' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: ' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "order_type": {
    "id": 6,
    "pickup_asap": false,
    "pickup_at": "2026-09-21 18:30:00"
  }
}'

No Body

The updated session.

Group Cart Show

Group Cart Lock