Skip to main content
POST
Start a cart at another merchant location

Authorizations

X-Cart-Token
string
header
required

Purpose-limited capability returned for a guest cart.

Headers

Idempotency-Key
string
required

Caller-stable key reused only for retries of this exact request.

Required string length: 16 - 128
Pattern: ^[A-Za-z0-9._:-]{16,128}$
If-Match
string
required

Current cart ETag returned by the API.

Pattern: ^(?:W/)?"cart-(?:0|[1-9][0-9]*)"$

Path Parameters

locationId
string
required
Required string length: 1 - 128
cartId
string
required
Required string length: 1 - 128

Body

application/json
targetLocationId
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
strategy
enum<string>
default:start_new_cart
Available options:
start_new_cart,
try_move_items
acceptedChanges
enum<boolean>
Available options:
true
fulfillmentMethod
enum<string>
Available options:
takeout,
table_side,
room_service,
delivery

Response

Move preview or destination cart.

outcome
enum<string>
required
Available options:
confirmation_required
sourceCartId
string
required
Required string length: 1 - 128
targetLocationId
string
required
Required string length: 1 - 128
differences
object[]
required