Group Cart Update My Cart
Replaces the caller's slice — the group equivalent of PUT /cart/{cart_id}. Send the whole slice, not a delta.
It only works while the session is open and the participant is not ready: a ready participant gets 1212 and has to reopen first. Guests are held to max_amount_per_participant if the host set one, and going over returns 1211.
Discounts and donations belong to the order as a whole, so only the host's slice may carry them; a guest sending them gets 1204.
Path Parameters
- Type: stringFormat: uuidgroup
_cart _uuid requiredUUID of the group cart session
Headers
- Type: stringApplicationrequired
White Label Application Key
- Type: stringApi
- Version requiredThe release version your integration was built against — see Versioning in API Basics.
- Type: stringContent
- Type requiredRequired even on requests with no body
- Type: stringX
- Mt - Group - Participant - Token requiredThe
participant_access_tokenreturned when this participant joined or created the session - Type: stringAuthorization
Bearer token of the signed-in customer. Omit it for an anonymous guest
- Type: stringDlc
- Authorization Punchh customer token, on a brand integrated with Punchh.
Authorizationdoes 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·
- Properties: 4Type: objectcartrequired
Responses
- 200
The updated slice, including
metadata.group_session. - 400
1204discounts or donations sent by a guest ·1206the session is locked or expired ·1211over the per-guest cap ·1212mark yourself not ready first ·1218conflicts with a restored manager discount - 401
The participant token is missing.
- 422
Validation failed.
curl https://api-public-demo.menu.app/api/group-cart/7c9e6679-f1e4-40b3-a2c5-e8f1a0b9d4c3/my-cart \
--request PUT \
--header 'Application: ' \
--header 'Api-Version: ' \
--header 'Content-Type: application/json' \
--header 'X-Mt-Group-Participant-Token: ' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"cart": {
"products": [
{}
],
"tip": {
"amount": 1,
"type": 1
},
"discounts": [
{}
],
"donations": [
{}
]
}
}'
