# cartDeliveryAddressesUpdate - storefront - MUTATION
Version: 2025-01

## Description
Updates one or more delivery addresses on a cart.

### Access Scopes



## Arguments
* [addresses](/docs/api/storefront/2025-01/input-objects/CartSelectableAddressUpdateInput): CartSelectableAddressUpdateInput! - The delivery addresses to update.

The input must not contain more than `250` values.
* [cartId](/docs/api/storefront/2025-01/scalars/ID): ID! - The ID of the cart.


## Returns
* [cart](/docs/api/storefront/2025-01/objects/Cart): Cart The updated cart.
* [userErrors](/docs/api/storefront/2025-01/objects/CartUserError): CartUserError! The list of errors that occurred from executing the mutation.
* [warnings](/docs/api/storefront/2025-01/objects/CartWarning): CartWarning! A list of warnings that occurred during the mutation.


## Examples
### Updates a delivery address on a cart
Curl example: "curl -X POST \\\nhttps://your-development-store.myshopify.com/api/2025-01/graphql.json \\\n-H 'Content-Type: application/json' \\\n-H 'X-Shopify-Storefront-Access-Token: {storefront_access_token}' \\\n-d '{\n\"query\": \"mutation CartDeliveryAddressesUpdate($id: ID!, $addresses: [CartSelectableAddressUpdateInput!]!) { cartDeliveryAddressesUpdate(cartId: $id, addresses: $addresses) { userErrors { message code field } warnings { message code target } cart { id delivery { addresses { id selected oneTimeUse address { ... on CartDeliveryAddress { firstName lastName company address1 address2 city provinceCode zip countryCode } } } } } } }\",\n \"variables\": {\n    \"id\": \"gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de\",\n    \"addresses\": [\n      {\n        \"id\": \"gid://shopify/CartSelectableAddress/delivery-address-1\",\n        \"selected\": true,\n        \"address\": {\n          \"copyFromCustomerAddressId\": \"gid://shopify/MailingAddress/544365967?model_name=CustomerAddress\"\n        }\n      }\n    ]\n  }\n}'\n"
Node example: "const client = new shopify.clients.Storefront({\n  domain: 'your-development-store.myshopify.com',\n  storefrontAccessToken,\n});\nconst data = await client.query({\n  data: {\n    \"query\": `mutation CartDeliveryAddressesUpdate($id: ID!, $addresses: [CartSelectableAddressUpdateInput!]!) {\n      cartDeliveryAddressesUpdate(cartId: $id, addresses: $addresses) {\n        userErrors {\n          message\n          code\n          field\n        }\n        warnings {\n          message\n          code\n          target\n        }\n        cart {\n          id\n          delivery {\n            addresses {\n              id\n              selected\n              oneTimeUse\n              address {\n                ... on CartDeliveryAddress {\n                  firstName\n                  lastName\n                  company\n                  address1\n                  address2\n                  city\n                  provinceCode\n                  zip\n                  countryCode\n                }\n              }\n            }\n          }\n        }\n      }\n    }`,\n    \"variables\": {\n      \"id\": \"gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de\",\n      \"addresses\": [\n        {\n          \"id\": \"gid://shopify/CartSelectableAddress/delivery-address-1\",\n          \"selected\": true,\n          \"address\": {\n            \"copyFromCustomerAddressId\": \"gid://shopify/MailingAddress/544365967?model_name=CustomerAddress\"\n          }\n        }\n      ]\n    },\n  },\n});\n"
Ruby example: null
Remix example: "const { storefront } = await unauthenticated.storefront(\n  'your-development-store.myshopify.com'\n);\n\nconst response = await storefront.graphql(\n  `#graphql\n  mutation CartDeliveryAddressesUpdate($id: ID!, $addresses: [CartSelectableAddressUpdateInput!]!) {\n    cartDeliveryAddressesUpdate(cartId: $id, addresses: $addresses) {\n      userErrors {\n        message\n        code\n        field\n      }\n      warnings {\n        message\n        code\n        target\n      }\n      cart {\n        id\n        delivery {\n          addresses {\n            id\n            selected\n            oneTimeUse\n            address {\n              ... on CartDeliveryAddress {\n                firstName\n                lastName\n                company\n                address1\n                address2\n                city\n                provinceCode\n                zip\n                countryCode\n              }\n            }\n          }\n        }\n      }\n    }\n  }`,\n  {\n    variables: {\n      \"id\": \"gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de\",\n      \"addresses\": [\n        {\n          \"id\": \"gid://shopify/CartSelectableAddress/delivery-address-1\",\n          \"selected\": true,\n          \"address\": {\n            \"copyFromCustomerAddressId\": \"gid://shopify/MailingAddress/544365967?model_name=CustomerAddress\"\n          }\n        }\n      ]\n    },\n  },\n);\n\nconst data = await response.json();\n"
Graphql query: "mutation CartDeliveryAddressesUpdate($id: ID!, $addresses: [CartSelectableAddressUpdateInput!]!) {\n  cartDeliveryAddressesUpdate(cartId: $id, addresses: $addresses) {\n    userErrors {\n      message\n      code\n      field\n    }\n    warnings {\n      message\n      code\n      target\n    }\n    cart {\n      id\n      delivery {\n        addresses {\n          id\n          selected\n          oneTimeUse\n          address {\n            ... on CartDeliveryAddress {\n              firstName\n              lastName\n              company\n              address1\n              address2\n              city\n              provinceCode\n              zip\n              countryCode\n            }\n          }\n        }\n      }\n    }\n  }\n}"
#### Graphql Input
{
  "id": "gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de",
  "addresses": [
    {
      "id": "gid://shopify/CartSelectableAddress/delivery-address-1",
      "selected": true,
      "address": {
        "copyFromCustomerAddressId": "gid://shopify/MailingAddress/544365967?model_name=CustomerAddress"
      }
    }
  ]
}
#### Graphql Response
{
  "data": {
    "cartDeliveryAddressesUpdate": {
      "userErrors": [],
      "warnings": [],
      "cart": {
        "id": "gid://shopify/Cart/c1-36e8477271a658e2ec3ebd1bf2506686?key=ba72b8f664bfb53a09522a0e789123de",
        "delivery": {
          "addresses": [
            {
              "id": "gid://shopify/CartSelectableAddress/delivery-address-1",
              "selected": true,
              "oneTimeUse": true,
              "address": {
                "firstName": "Bob",
                "lastName": "Bobsen",
                "company": null,
                "address1": "123 Amoebobacterieae St",
                "address2": null,
                "city": "Ottawa",
                "provinceCode": "ON",
                "zip": "K2P0V6",
                "countryCode": "CA"
              }
            }
          ]
        }
      }
    }
  },
  "extensions": {
    "cart": {
      "serialized": {
        "c1-36e8477271a658e2ec3ebd1bf2506686": "eNq9Us-LI1UQ7k4y2Ww7YAyCS07D6EFHsvR7nf7lbWK6M9sz6Uxep19n-iKv-71MMv0mPyY9SU8QEQWRRRCXPXj2uAdBj7uCMBfZvXgT8Tj4P6zsyRYvC7JXD1VUfcVX1FdV0tsxaCgaM5q6DnVANNVgkMUKiyiIRlCVNc3Qqp_9-nS7_kWxn6B7WJ6vg4QPXDzuEC9tu_K62Q3sQ2bPCe7g7gn2MzpwUWBlbbRBl93k9Aq1eRhiZzrgvtxX5i1m8w6znSD0U_dQsdQ-XGekHS6OlFCNMDoL7NbKPXOSyOIKGtAkHForlixhPwCXgyC1vQB1w3MLYo6OjzaO1x-2fJfbfreTrnrt5KLnqwvM-6sY-sDjTkY4DT0lVns-tSgeX1Ecrn3PXJxwDLp-tgwO3Anl8aZ75rohdCc5P2Cduer62ZByZ403eOHj_YzY-JIkDo-xvYgsf4PwqdpXYplN5zZN5laM-fFJjsUAWagdZmjKx33ZWZHh-ITK6YHLqTWwxgOGu-kRPoW-3UoCn68wzBKq3MtC20qP_LRH4PgAgbmHDmjfG4ZkkGQYHdjewLLM474stu5IklSU78q14nA4rL0UO6-soO3Kbw-_elKufvnn_Rsx3K78_m_2_Ifrwqfi10-efl54Jr6SfSMK3xVfk25PZ-lHo9nllP5YFB4Xd6WdiOgwMkaa1oxGkaoQ2VQhJDLTDRNAhbI__mGlbJneHc-W6YOS8KyUs5qQURbHUDeAqUQ6aapq_oCmDJsmUZgm35R2YgPomqaMdGjmzUlEDENXTWhSkKNmpL8o5RK-f_RTufrXN9_-XHhUflioCXVh9xdRuhZzGRWpUBFque0u6wspkN7Kx9nZP5-xaBaROGUXE0bYjpfWy700JWuyV_hwH25JxdYs-qCcuyWbtt6QXn8fvKsB5T1VVRsAAuhUpPIhPJaxhkpSoedWxfqbUo0yPlmxi6sGofSCLZcNsJdXKyLMx1iOJ_P5ZHoKb0lbfBYT3nrHiCCQjZHeMJhmNpogjhuEmM2GJkPCqAr1JgBVca9a266_dII7IvwP4ggoV30t5r17qG2hF6Jwv3BbuiUVU5LVhAcF4XH5E-lj6f9fQI5vEXo-mf4NsYg6dA=="
      }
    }
  }
}