cartSetCurrent

Mutationin Multiple carts

Choose which of the caller's carts is the current one, as returned by the cart query. Modifies no cart. An archived cart it chooses reads ACTIVE while it is the current one, and the buyer's next change keeps it so.

Arguments

Argument	Type	Description
`id`	`ID!`

Returns

CartSetCurrentResponse!

Field	Type	Description
`cart`	`Cart`	The cart that is now current. Write this into the cart query.
`cartErrors`	`[CartSetCurrentError!]`	Error details if the cart could not be made current

Example

mutation CartSetCurrent($id: ID!) {
  cartSetCurrent(id: $id) {
    cart {
      id
      version
      createdAt
      lastModifiedAt
      currency
      customerEmail
      isGuest
      totalQuantity
      deliveryRemarks
      vatNumber
      purchaseOrderNumber
      deliverySplit
      requestedDeliveryDate
      earliestCompleteDeliveryDate
      name
      defaultName
      status
    }
    cartErrors {
      __typename
      ... on ValidationError {
        message
      }
      ... on CartError {
        message
        code
      }
    }
  }
}

{
  "id": "id-1"
}

{
  "data": {
    "cartSetCurrent": {
      "cart": {
        "id": "id-1",
        "version": "Example",
        "createdAt": "2026-10-01T09:30:00Z",
        "lastModifiedAt": "2026-10-01T09:30:00Z",
        "currency": "EUR",
        "customerEmail": "jane@example.com",
        "isGuest": true,
        "totalQuantity": 1,
        "deliveryRemarks": "Example",
        "vatNumber": "Example",
        "purchaseOrderNumber": "Example",
        "deliverySplit": "COMPLETE",
        "requestedDeliveryDate": "2026-10-01",
        "earliestCompleteDeliveryDate": "2026-10-01",
        "name": "Example",
        "defaultName": "Example",
        "status": "ACTIVE"
      },
      "cartErrors": [
        {
          "__typename": "ValidationError",
          "message": "Example"
        }
      ]
    }
  }
}

The query selects the return type's fields two levels deep; pick the ones you need. The response shows its shape with placeholder values.

Served by

@evolve-framework/commercetools	Resolved
@evolve-framework/medusa	Resolved

Used by

The storefront packages that send it, in these GraphQL documents:

@evolve-storefront/feature-cart: CartSetCurrent