Remove a single item selection from cart

Removes a single item selection from the cart by its externalId. To remove multiple items, send a request for each item (one request per externalId). Returns cart with updated pricing and any validation problems.

SecurityOAuth2
Request
path Parameters
externalId
required
string

The partner provided external identifier for the cart item.

Example: item-3324232
guid
required
string <uuid>

The identifier of the cart.

header Parameters
Toast-Restaurant-External-ID
string <uuid>

The identifier of the location.

Responses
200

Successful operation. Cart item removed from cart.

403

Unauthorized access.

404

Cart not found.

delete/carts/v1/carts/{guid}/selections/{externalId}
Request samples
curl -i -X DELETE \
  'https://ws-api.toasttab.com/carts/v1/carts/{guid}/selections/{externalId}' \
  -H 'Authorization: Bearer <YOUR_TOKEN_HERE>' \
  -H 'Toast-Restaurant-External-ID: 497f6eca-6276-4993-bfeb-53cbbbba6f08'
Response samples
application/json
{
  • "cart": {
    },
  • "problems": [
    ]
}