> This page is for Developer.

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.bigcommerce.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.bigcommerce.com/_mcp/server.

# updateCheckout

GraphQL MUTATION

Update a checkout.

Reference: https://docs.bigcommerce.com/developer/api-reference/graphql/storefront/mutations/checkout/update-checkout

## GraphQL Schema

```graphql
mutation ExampleMutation($input: UpdateCheckoutInput!) {
  checkout {
    updateCheckout(input: $input) {
      checkout {
        id
        entityId
        currencyCode
        displayCurrencyCode
        billingAddress
        cart
        shippingConsignments
        shippingCostTotal
        shippingCostTotalInDisplayCurrency
        shippingCostBeforeDiscount
      }
      errors
    }
  }
}
```

## Variables

```json
{
  "input": {
    "checkoutEntityId": "example",
    "data": {
      "lineItems": [
        {
          "entityId": "example",
          "quantity": 0,
          "productEntityId": 0,
          "variantEntityId": 0,
          "sku": "example",
          "selectedOptions": {
            "checkboxes": [
              {
                "optionEntityId": null,
                "optionValueEntityId": null
              }
            ],
            "dateFields": [
              {
                "optionEntityId": null,
                "date": null
              }
            ],
            "multiLineTextFields": [
              {
                "optionEntityId": null,
                "text": null
              }
            ],
            "multipleChoices": [
              {
                "optionEntityId": null,
                "optionValueEntityId": null
              }
            ],
            "numberFields": [
              {
                "optionEntityId": null,
                "number": null
              }
            ],
            "textFields": [
              {
                "optionEntityId": null,
                "text": null
              }
            ]
          }
        }
      ],
      "shippingConsignments": [
        {
          "entityId": "example",
          "address": {
            "firstName": "example",
            "lastName": "example",
            "email": "example",
            "company": "example",
            "address1": "example",
            "address2": "example",
            "city": "example",
            "stateOrProvince": "example",
            "stateOrProvinceCode": "example",
            "countryCode": "example"
          },
          "lineItems": [
            {
              "lineItemEntityId": "example",
              "quantity": 0
            }
          ],
          "shippingOptionEntityId": "example",
          "selectRecommendedOption": true,
          "shippingOptionSelectionStrategy": "LEAST_EXPENSIVE"
        }
      ],
      "billingAddress": {
        "firstName": "example",
        "lastName": "example",
        "email": "example",
        "company": "example",
        "address1": "example",
        "address2": "example",
        "city": "example",
        "stateOrProvince": "example",
        "stateOrProvinceCode": "example",
        "countryCode": "example"
      },
      "customerMessage": "example",
      "coupons": [
        "example"
      ]
    },
    "version": 0
  }
}
```