Skip to main content
PATCH
Update cart items prices

Authorizations

Authorization
string
header
required

Bearer token authentication

Path Parameters

cart_token
string
required

Cart token

Body

application/json
cart_token
string

Token of the cart to update

cart_items
(object | null)[] | null

Array of cart items with their new prices

price_authority
object | null

Whether the caller is taking control of these prices, or handing control back. Omit it (or send null) to override prices without recording a hold, which is how this endpoint has always behaved. An empty object claims the prices for the caller. The holder is derived from the authenticated credential and is never accepted from the request body, so a caller cannot present itself as a different holder. Holds are not exclusive. A hold records whoever last set the price, so a later override or claim by another holder moves it, which is how admin tooling overrides an integration's price. What is protected is handing a hold back, which only ever affects the calling holder's own items. A credential that resolves to no holder (a customer or portal-member token) is rejected with 422.

Response

object | null

Success

cart
object | null
meta
object | null