Choose a version:

Anchor to productVariantRelationshipBulkUpdate

productVariantRelationshipBulkUpdate

mutation

Requires write_products access scope. Also: The shop must have access to bundles feature.

Creates new bundles, updates component quantities in existing bundles, and removes bundle components for one or multiple ProductVariant objects.

Each bundle variant can contain up to 30 component variants with specified quantities. After an app assigns components to a bundle, only that app can manage those components.

Note

For most use cases, use productBundleCreate instead, which creates product fixed bundles. productVariantRelationshipBulkUpdate is for variant fixed bundles, where each variant has its own component configuration.

Anchor to Arguments

Arguments

Anchor to inputinput

•[ProductVariantRelationshipUpdateInput!]!

required

The input options for the product variant being updated.

Was this section helpful?

Anchor to ProductVariantRelationshipBulkUpdatePayload returnsProductVariantRelationshipBulkUpdatePayload returns

Anchor to parentProductVariantsparentProductVariants •[ProductVariant!]: The product variants with successfully updated product variant relationships.
Anchor to userErrorsuserErrors •[ProductVariantRelationshipBulkUpdateUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Create a bundle by adding components to a product variant

Description

Creates a new product variant relationship between the parent variant and the child variant passed in the input.

Query

mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {
  productVariantRelationshipBulkUpdate(input: $input) {
    parentProductVariants {
      id
      productVariantComponents(first: 10) {
        nodes {
          id
          productVariant {
            id
            displayName
          }
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}

Variables

{
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToCreate": [
        {
          "id": "gid://shopify/ProductVariant/149896808",
          "quantity": 1
        },
        {
          "id": "gid://shopify/ProductVariant/709406719",
          "quantity": 1
        }
      ]
    }
  ]
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) { productVariantRelationshipBulkUpdate(input: $input) { parentProductVariants { id productVariantComponents(first: 10) { nodes { id productVariant { id displayName } } } } userErrors { code field message } } }",
 "variables": {
    "input": [
      {
        "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
        "productVariantRelationshipsToCreate": [
          {
            "id": "gid://shopify/ProductVariant/149896808",
            "quantity": 1
          },
          {
            "id": "gid://shopify/ProductVariant/709406719",
            "quantity": 1
          }
        ]
      }
    ]
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {
    productVariantRelationshipBulkUpdate(input: $input) {
      parentProductVariants {
        id
        productVariantComponents(first: 10) {
          nodes {
            id
            productVariant {
              id
              displayName
            }
          }
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "input": [
            {
                "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
                "productVariantRelationshipsToCreate": [
                    {
                        "id": "gid://shopify/ProductVariant/149896808",
                        "quantity": 1
                    },
                    {
                        "id": "gid://shopify/ProductVariant/709406719",
                        "quantity": 1
                    }
                ]
            }
        ]
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {
    productVariantRelationshipBulkUpdate(input: $input) {
      parentProductVariants {
        id
        productVariantComponents(first: 10) {
          nodes {
            id
            productVariant {
              id
              displayName
            }
          }
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToCreate": [
        {
          "id": "gid://shopify/ProductVariant/149896808",
          "quantity": 1
        },
        {
          "id": "gid://shopify/ProductVariant/709406719",
          "quantity": 1
        }
      ]
    }
  ]
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {
      productVariantRelationshipBulkUpdate(input: $input) {
        parentProductVariants {
          id
          productVariantComponents(first: 10) {
            nodes {
              id
              productVariant {
                id
                displayName
              }
            }
          }
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "input": [
            {
                "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
                "productVariantRelationshipsToCreate": [
                    {
                        "id": "gid://shopify/ProductVariant/149896808",
                        "quantity": 1
                    },
                    {
                        "id": "gid://shopify/ProductVariant/709406719",
                        "quantity": 1
                    }
                ]
            }
        ]
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {
  productVariantRelationshipBulkUpdate(input: $input) {
    parentProductVariants {
      id
      productVariantComponents(first: 10) {
        nodes {
          id
          productVariant {
            id
            displayName
          }
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}' \
--variables \
'{
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToCreate": [
        {
          "id": "gid://shopify/ProductVariant/149896808",
          "quantity": 1
        },
        {
          "id": "gid://shopify/ProductVariant/709406719",
          "quantity": 1
        }
      ]
    }
  ]
}'

Response

{
  "productVariantRelationshipBulkUpdate": {
    "parentProductVariants": [
      {
        "id": "gid://shopify/ProductVariant/799757249",
        "productVariantComponents": {
          "nodes": [
            {
              "id": "gid://shopify/ProductVariantComponent/993184086",
              "productVariant": {
                "id": "gid://shopify/ProductVariant/149896808",
                "displayName": "Composite_Sauce_Pack - component_product_variant_classic_hot_sauce"
              }
            },
            {
              "id": "gid://shopify/ProductVariantComponent/993184087",
              "productVariant": {
                "id": "gid://shopify/ProductVariant/709406719",
                "displayName": "Composite_Sauce_Pack - component_product_variant_classic_garlic_sauce"
              }
            }
          ]
        }
      }
    ],
    "userErrors": []
  }
}

Delete a product variant component

Description

Removes all the product variant relationships associated with a variant.

Query

mutation RemoveABundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) {
  productVariantRelationshipBulkUpdate(input: $input) {
    parentProductVariants {
      id
      productVariantComponents(first: 10) {
        nodes {
          id
          productVariant {
            id
            displayName
          }
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}

Variables

{
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToRemove": [
        "gid://shopify/ProductVariant/149896808"
      ]
    }
  ]
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation RemoveABundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) { productVariantRelationshipBulkUpdate(input: $input) { parentProductVariants { id productVariantComponents(first: 10) { nodes { id productVariant { id displayName } } } } userErrors { code field message } } }",
 "variables": {
    "input": [
      {
        "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
        "productVariantRelationshipsToRemove": [
          "gid://shopify/ProductVariant/149896808"
        ]
      }
    ]
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation RemoveABundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) {
    productVariantRelationshipBulkUpdate(input: $input) {
      parentProductVariants {
        id
        productVariantComponents(first: 10) {
          nodes {
            id
            productVariant {
              id
              displayName
            }
          }
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "input": [
            {
                "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
                "productVariantRelationshipsToRemove": [
                    "gid://shopify/ProductVariant/149896808"
                ]
            }
        ]
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation RemoveABundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) {
    productVariantRelationshipBulkUpdate(input: $input) {
      parentProductVariants {
        id
        productVariantComponents(first: 10) {
          nodes {
            id
            productVariant {
              id
              displayName
            }
          }
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToRemove": [
        "gid://shopify/ProductVariant/149896808"
      ]
    }
  ]
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation RemoveABundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) {
      productVariantRelationshipBulkUpdate(input: $input) {
        parentProductVariants {
          id
          productVariantComponents(first: 10) {
            nodes {
              id
              productVariant {
                id
                displayName
              }
            }
          }
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "input": [
            {
                "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
                "productVariantRelationshipsToRemove": [
                    "gid://shopify/ProductVariant/149896808"
                ]
            }
        ]
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation RemoveABundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) {
  productVariantRelationshipBulkUpdate(input: $input) {
    parentProductVariants {
      id
      productVariantComponents(first: 10) {
        nodes {
          id
          productVariant {
            id
            displayName
          }
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}' \
--variables \
'{
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToRemove": [
        "gid://shopify/ProductVariant/149896808"
      ]
    }
  ]
}'

Response

{
  "productVariantRelationshipBulkUpdate": {
    "parentProductVariants": [
      {
        "id": "gid://shopify/ProductVariant/799757249",
        "productVariantComponents": {
          "nodes": [
            {
              "id": "gid://shopify/ProductVariantComponent/636669297",
              "productVariant": {
                "id": "gid://shopify/ProductVariant/709406719",
                "displayName": "Composite_Sauce_Pack - component_product_variant_classic_garlic_sauce"
              }
            }
          ]
        }
      }
    ],
    "userErrors": []
  }
}

Remove all product variant components of a bundle

Description

Removes all the product variant relationships associated with a variant.

Query

mutation RemoveAllBundleComponents($input: [ProductVariantRelationshipUpdateInput!]!) {
  productVariantRelationshipBulkUpdate(input: $input) {
    parentProductVariants {
      id
      productVariantComponents(first: 10) {
        nodes {
          id
          productVariant {
            id
            displayName
          }
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}

Variables

{
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "removeAllProductVariantRelationships": true
    }
  ]
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation RemoveAllBundleComponents($input: [ProductVariantRelationshipUpdateInput!]!) { productVariantRelationshipBulkUpdate(input: $input) { parentProductVariants { id productVariantComponents(first: 10) { nodes { id productVariant { id displayName } } } } userErrors { code field message } } }",
 "variables": {
    "input": [
      {
        "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
        "removeAllProductVariantRelationships": true
      }
    ]
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation RemoveAllBundleComponents($input: [ProductVariantRelationshipUpdateInput!]!) {
    productVariantRelationshipBulkUpdate(input: $input) {
      parentProductVariants {
        id
        productVariantComponents(first: 10) {
          nodes {
            id
            productVariant {
              id
              displayName
            }
          }
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "input": [
            {
                "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
                "removeAllProductVariantRelationships": true
            }
        ]
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation RemoveAllBundleComponents($input: [ProductVariantRelationshipUpdateInput!]!) {
    productVariantRelationshipBulkUpdate(input: $input) {
      parentProductVariants {
        id
        productVariantComponents(first: 10) {
          nodes {
            id
            productVariant {
              id
              displayName
            }
          }
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "removeAllProductVariantRelationships": true
    }
  ]
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation RemoveAllBundleComponents($input: [ProductVariantRelationshipUpdateInput!]!) {
      productVariantRelationshipBulkUpdate(input: $input) {
        parentProductVariants {
          id
          productVariantComponents(first: 10) {
            nodes {
              id
              productVariant {
                id
                displayName
              }
            }
          }
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "input": [
            {
                "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
                "removeAllProductVariantRelationships": true
            }
        ]
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation RemoveAllBundleComponents($input: [ProductVariantRelationshipUpdateInput!]!) {
  productVariantRelationshipBulkUpdate(input: $input) {
    parentProductVariants {
      id
      productVariantComponents(first: 10) {
        nodes {
          id
          productVariant {
            id
            displayName
          }
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}' \
--variables \
'{
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "removeAllProductVariantRelationships": true
    }
  ]
}'

Response

{
  "productVariantRelationshipBulkUpdate": {
    "parentProductVariants": [
      {
        "id": "gid://shopify/ProductVariant/799757249",
        "productVariantComponents": {
          "nodes": []
        }
      }
    ],
    "userErrors": []
  }
}

Update a product variant relationship

Description

Updates the quantity of a bundle component.

Query

mutation UpdateBundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) {
  productVariantRelationshipBulkUpdate(input: $input) {
    parentProductVariants {
      id
      productVariantComponents(first: 10) {
        nodes {
          id
          productVariant {
            id
            displayName
          }
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}

Variables

{
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToUpdate": [
        {
          "id": "gid://shopify/ProductVariant/149896808",
          "quantity": 33
        }
      ]
    }
  ]
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation UpdateBundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) { productVariantRelationshipBulkUpdate(input: $input) { parentProductVariants { id productVariantComponents(first: 10) { nodes { id productVariant { id displayName } } } } userErrors { code field message } } }",
 "variables": {
    "input": [
      {
        "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
        "productVariantRelationshipsToUpdate": [
          {
            "id": "gid://shopify/ProductVariant/149896808",
            "quantity": 33
          }
        ]
      }
    ]
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation UpdateBundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) {
    productVariantRelationshipBulkUpdate(input: $input) {
      parentProductVariants {
        id
        productVariantComponents(first: 10) {
          nodes {
            id
            productVariant {
              id
              displayName
            }
          }
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "input": [
            {
                "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
                "productVariantRelationshipsToUpdate": [
                    {
                        "id": "gid://shopify/ProductVariant/149896808",
                        "quantity": 33
                    }
                ]
            }
        ]
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation UpdateBundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) {
    productVariantRelationshipBulkUpdate(input: $input) {
      parentProductVariants {
        id
        productVariantComponents(first: 10) {
          nodes {
            id
            productVariant {
              id
              displayName
            }
          }
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToUpdate": [
        {
          "id": "gid://shopify/ProductVariant/149896808",
          "quantity": 33
        }
      ]
    }
  ]
}

response = client.query(query: query, variables: variables)

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation UpdateBundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) {
      productVariantRelationshipBulkUpdate(input: $input) {
        parentProductVariants {
          id
          productVariantComponents(first: 10) {
            nodes {
              id
              productVariant {
                id
                displayName
              }
            }
          }
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "input": [
            {
                "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
                "productVariantRelationshipsToUpdate": [
                    {
                        "id": "gid://shopify/ProductVariant/149896808",
                        "quantity": 33
                    }
                ]
            }
        ]
    },
  },
});

Shopify CLI

shopify app execute \
--query \
'mutation UpdateBundleComponent($input: [ProductVariantRelationshipUpdateInput!]!) {
  productVariantRelationshipBulkUpdate(input: $input) {
    parentProductVariants {
      id
      productVariantComponents(first: 10) {
        nodes {
          id
          productVariant {
            id
            displayName
          }
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}' \
--variables \
'{
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToUpdate": [
        {
          "id": "gid://shopify/ProductVariant/149896808",
          "quantity": 33
        }
      ]
    }
  ]
}'

Response

{
  "productVariantRelationshipBulkUpdate": {
    "parentProductVariants": [
      {
        "id": "gid://shopify/ProductVariant/799757249",
        "productVariantComponents": {
          "nodes": [
            {
              "id": "gid://shopify/ProductVariantComponent/477596995",
              "productVariant": {
                "id": "gid://shopify/ProductVariant/149896808",
                "displayName": "Composite_Sauce_Pack - component_product_variant_classic_hot_sauce"
              }
            },
            {
              "id": "gid://shopify/ProductVariantComponent/636669297",
              "productVariant": {
                "id": "gid://shopify/ProductVariant/709406719",
                "displayName": "Composite_Sauce_Pack - component_product_variant_classic_garlic_sauce"
              }
            }
          ]
        }
      }
    ],
    "userErrors": []
  }
}

productVariantRelationshipBulkUpdate reference

Examples

Open in GraphiQL

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {

const { admin } = await authenticate.admin(request);

const response = await admin.graphql(

`#graphql

mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {

productVariantRelationshipBulkUpdate(input: $input) {

parentProductVariants {

productVariantComponents(first: 10) {

nodes {

productVariant {

displayName

}

userErrors {

code

field

message

}

}`,

{

variables: {

"input": [

{

"parentProductVariantId": "gid://shopify/ProductVariant/799757249",

"productVariantRelationshipsToCreate": [

{

"id": "gid://shopify/ProductVariant/149896808",

"quantity": 1

{

"id": "gid://shopify/ProductVariant/709406719",

"quantity": 1

}

]

}

]

);

const json = await response.json();

return json.data;

}

GQL

mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {
  productVariantRelationshipBulkUpdate(input: $input) {
    parentProductVariants {
      id
      productVariantComponents(first: 10) {
        nodes {
          id
          productVariant {
            id
            displayName
          }
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2026-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) { productVariantRelationshipBulkUpdate(input: $input) { parentProductVariants { id productVariantComponents(first: 10) { nodes { id productVariant { id displayName } } } } userErrors { code field message } } }",
 "variables": {
    "input": [
      {
        "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
        "productVariantRelationshipsToCreate": [
          {
            "id": "gid://shopify/ProductVariant/149896808",
            "quantity": 1
          },
          {
            "id": "gid://shopify/ProductVariant/709406719",
            "quantity": 1
          }
        ]
      }
    ]
  }
}'

React Router

import { authenticate } from "../shopify.server";

export const loader = async ({request}) => {
  const { admin } = await authenticate.admin(request);
  const response = await admin.graphql(
    `#graphql
  mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {
    productVariantRelationshipBulkUpdate(input: $input) {
      parentProductVariants {
        id
        productVariantComponents(first: 10) {
          nodes {
            id
            productVariant {
              id
              displayName
            }
          }
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "input": [
            {
                "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
                "productVariantRelationshipsToCreate": [
                    {
                        "id": "gid://shopify/ProductVariant/149896808",
                        "quantity": 1
                    },
                    {
                        "id": "gid://shopify/ProductVariant/709406719",
                        "quantity": 1
                    }
                ]
            }
        ]
    },
  },
  );
  const json = await response.json();
  return json.data;
}

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {
      productVariantRelationshipBulkUpdate(input: $input) {
        parentProductVariants {
          id
          productVariantComponents(first: 10) {
            nodes {
              id
              productVariant {
                id
                displayName
              }
            }
          }
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "input": [
            {
                "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
                "productVariantRelationshipsToCreate": [
                    {
                        "id": "gid://shopify/ProductVariant/149896808",
                        "quantity": 1
                    },
                    {
                        "id": "gid://shopify/ProductVariant/709406719",
                        "quantity": 1
                    }
                ]
            }
        ]
    },
  },
});

Ruby

session = ShopifyAPI::Auth::Session.new(
  shop: "your-development-store.myshopify.com",
  access_token: access_token
)
client = ShopifyAPI::Clients::Graphql::Admin.new(
  session: session
)

query = <<~QUERY
  mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {
    productVariantRelationshipBulkUpdate(input: $input) {
      parentProductVariants {
        id
        productVariantComponents(first: 10) {
          nodes {
            id
            productVariant {
              id
              displayName
            }
          }
        }
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToCreate": [
        {
          "id": "gid://shopify/ProductVariant/149896808",
          "quantity": 1
        },
        {
          "id": "gid://shopify/ProductVariant/709406719",
          "quantity": 1
        }
      ]
    }
  ]
}

response = client.query(query: query, variables: variables)

Shopify CLI

shopify app execute \
--query \
'mutation CreateBundle($input: [ProductVariantRelationshipUpdateInput!]!) {
  productVariantRelationshipBulkUpdate(input: $input) {
    parentProductVariants {
      id
      productVariantComponents(first: 10) {
        nodes {
          id
          productVariant {
            id
            displayName
          }
        }
      }
    }
    userErrors {
      code
      field
      message
    }
  }
}' \
--variables \
'{
  "input": [
    {
      "parentProductVariantId": "gid://shopify/ProductVariant/799757249",
      "productVariantRelationshipsToCreate": [
        {
          "id": "gid://shopify/ProductVariant/149896808",
          "quantity": 1
        },
        {
          "id": "gid://shopify/ProductVariant/709406719",
          "quantity": 1
        }
      ]
    }
  ]
}'

Input variables

JSON

{

"input": [

{

"parentProductVariantId": "gid://shopify/ProductVariant/799757249",

"productVariantRelationshipsToCreate": [

{

"id": "gid://shopify/ProductVariant/149896808",

"quantity": 1

{

"id": "gid://shopify/ProductVariant/709406719",

"quantity": 1

}

]

}

]

}

Response

JSON

{

"productVariantRelationshipBulkUpdate": {

"parentProductVariants": [

{

"id": "gid://shopify/ProductVariant/799757249",

"productVariantComponents": {

"nodes": [

{

"id": "gid://shopify/ProductVariantComponent/993184086",

"productVariant": {

"id": "gid://shopify/ProductVariant/149896808",

"displayName": "Composite_Sauce_Pack - component_product_variant_classic_hot_sauce"

}

{

"id": "gid://shopify/ProductVariantComponent/993184087",

"productVariant": {

"id": "gid://shopify/ProductVariant/709406719",

"displayName": "Composite_Sauce_Pack - component_product_variant_classic_garlic_sauce"

}

]

}

"userErrors": []

}