Choose a version:

discountAutomaticBulkDelete

mutation

Requires Apps must have write_discounts access scope.

Asynchronously delete automatic discounts in bulk if a search or saved_search_id argument is provided or if a maximum discount threshold is reached (1,000). Otherwise, deletions will occur inline. Warning: All automatic discounts will be deleted if a blank search argument is provided.

Arguments

Anchor to idsids •[ID!]: The IDs of the automatic discounts to delete.
Anchor to savedSearchIdsavedSearchId •ID: The ID of the saved search to use for filtering automatic discounts to delete.
Anchor to searchsearch •String: The search query for filtering automatic discounts to delete.

For more information on the list of supported fields and search syntax, refer to the AutomaticDiscountNodes query section.

Was this section helpful?

Anchor to DiscountAutomaticBulkDeletePayload returnsDiscountAutomaticBulkDeletePayload returns

Anchor to jobjob •Job: The asynchronous job removing the automatic discounts.
Anchor to userErrorsuserErrors •[DiscountUserError!]! non-null: The list of errors that occurred from executing the mutation.

Was this section helpful?

Examples

Asynchronously delete automatic discounts in bulk using a search filter

Description

Asynchronously delete all expired automatic discounts that are type `percentage`.

Query

mutation discountAutomaticBulkDelete($search: String) {
  discountAutomaticBulkDelete(search: $search) {
    job {
      id
    }
    userErrors {
      code
      field
      message
    }
  }
}

Variables

{
  "search": "type:percentage status:expired"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation discountAutomaticBulkDelete($search: String) { discountAutomaticBulkDelete(search: $search) { job { id } userErrors { code field message } } }",
 "variables": {
    "search": "type:percentage status:expired"
  }
}'

Remix

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

const response = await admin.graphql(
  `#graphql
  mutation discountAutomaticBulkDelete($search: String) {
    discountAutomaticBulkDelete(search: $search) {
      job {
        id
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "search": "type:percentage status:expired"
    },
  },
);

const data = await response.json();

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 discountAutomaticBulkDelete($search: String) {
    discountAutomaticBulkDelete(search: $search) {
      job {
        id
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "search": "type:percentage status:expired"
}

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

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation discountAutomaticBulkDelete($search: String) {
      discountAutomaticBulkDelete(search: $search) {
        job {
          id
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "search": "type:percentage status:expired"
    },
  },
});

Response

{
  "discountAutomaticBulkDelete": {
    "job": {
      "id": "gid://shopify/Job/11a6c2db-7d58-4a77-ac7b-7128dd68b8aa"
    },
    "userErrors": []
  }
}

Using more than one targeting argument returns an error

Description

Trying to use both `search` and `ids` arguments returns an error

Query

mutation discountAutomaticBulkDelete($search: String, $ids: [ID!]) {
  discountAutomaticBulkDelete(search: $search, ids: $ids) {
    job {
      id
    }
    userErrors {
      code
      field
      message
    }
  }
}

Variables

{
  "ids": [
    "gid://shopify/DiscountAutomaticNode/1"
  ],
  "search": "type:bxgy"
}

cURL

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation discountAutomaticBulkDelete($search: String, $ids: [ID!]) { discountAutomaticBulkDelete(search: $search, ids: $ids) { job { id } userErrors { code field message } } }",
 "variables": {
    "ids": [
      "gid://shopify/DiscountAutomaticNode/1"
    ],
    "search": "type:bxgy"
  }
}'

Remix

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

const response = await admin.graphql(
  `#graphql
  mutation discountAutomaticBulkDelete($search: String, $ids: [ID!]) {
    discountAutomaticBulkDelete(search: $search, ids: $ids) {
      job {
        id
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "ids": [
            "gid://shopify/DiscountAutomaticNode/1"
        ],
        "search": "type:bxgy"
    },
  },
);

const data = await response.json();

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 discountAutomaticBulkDelete($search: String, $ids: [ID!]) {
    discountAutomaticBulkDelete(search: $search, ids: $ids) {
      job {
        id
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "ids": [
    "gid://shopify/DiscountAutomaticNode/1"
  ],
  "search": "type:bxgy"
}

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

Node.js

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation discountAutomaticBulkDelete($search: String, $ids: [ID!]) {
      discountAutomaticBulkDelete(search: $search, ids: $ids) {
        job {
          id
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "ids": [
            "gid://shopify/DiscountAutomaticNode/1"
        ],
        "search": "type:bxgy"
    },
  },
});

Response

{
  "discountAutomaticBulkDelete": {
    "job": null,
    "userErrors": [
      {
        "code": "TOO_MANY_ARGUMENTS",
        "field": null,
        "message": "Only one of IDs, search argument or saved search ID is allowed."
      }
    ]
  }
}

discountAutomaticBulkDelete reference

Examples

Open in GraphiQL

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

const response = await admin.graphql(

`#graphql

mutation discountAutomaticBulkDelete($search: String) {

discountAutomaticBulkDelete(search: $search) {

job {

}

userErrors {

code

field

message

}

}`,

{

variables: {

"search": "type:percentage status:expired"

);

const data = await response.json();

mutation discountAutomaticBulkDelete($search: String) {
  discountAutomaticBulkDelete(search: $search) {
    job {
      id
    }
    userErrors {
      code
      field
      message
    }
  }
}

curl -X POST \
https://your-development-store.myshopify.com/admin/api/2025-01/graphql.json \
-H 'Content-Type: application/json' \
-H 'X-Shopify-Access-Token: {access_token}' \
-d '{
"query": "mutation discountAutomaticBulkDelete($search: String) { discountAutomaticBulkDelete(search: $search) { job { id } userErrors { code field message } } }",
 "variables": {
    "search": "type:percentage status:expired"
  }
}'

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

const response = await admin.graphql(
  `#graphql
  mutation discountAutomaticBulkDelete($search: String) {
    discountAutomaticBulkDelete(search: $search) {
      job {
        id
      }
      userErrors {
        code
        field
        message
      }
    }
  }`,
  {
    variables: {
        "search": "type:percentage status:expired"
    },
  },
);

const data = await response.json();

const client = new shopify.clients.Graphql({session});
const data = await client.query({
  data: {
    "query": `mutation discountAutomaticBulkDelete($search: String) {
      discountAutomaticBulkDelete(search: $search) {
        job {
          id
        }
        userErrors {
          code
          field
          message
        }
      }
    }`,
    "variables": {
        "search": "type:percentage status:expired"
    },
  },
});

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 discountAutomaticBulkDelete($search: String) {
    discountAutomaticBulkDelete(search: $search) {
      job {
        id
      }
      userErrors {
        code
        field
        message
      }
    }
  }
QUERY

variables = {
  "search": "type:percentage status:expired"
}

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

Input variables

JSON

{

"search": "type:percentage status:expired"

}

Response

JSON

{

"discountAutomaticBulkDelete": {

"job": {

"id": "gid://shopify/Job/11a6c2db-7d58-4a77-ac7b-7128dd68b8aa"

"userErrors": []

}