From f4f3145793c848dc464848cd1d012059217b94eb Mon Sep 17 00:00:00 2001 From: Russ Johnson Date: Mon, 3 Aug 2026 14:19:29 +0200 Subject: [PATCH 1/5] USF-4239: add product alert GraphQL mutations and queries documentation --- .../graphql/schema/product-alert/index.md | 35 +++++++++ .../mutations/subscribe-price.md | 78 +++++++++++++++++++ .../mutations/subscribe-stock.md | 78 +++++++++++++++++++ .../mutations/unsubscribe-price-all.md | 68 ++++++++++++++++ .../mutations/unsubscribe-price.md | 78 +++++++++++++++++++ .../mutations/unsubscribe-stock-all.md | 68 ++++++++++++++++ .../mutations/unsubscribe-stock.md | 78 +++++++++++++++++++ .../queries/is-subscribed-price.md | 78 +++++++++++++++++++ .../queries/is-subscribed-stock.md | 78 +++++++++++++++++++ 9 files changed, 639 insertions(+) create mode 100644 src/pages/graphql/schema/product-alert/index.md create mode 100644 src/pages/graphql/schema/product-alert/mutations/subscribe-price.md create mode 100644 src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md create mode 100644 src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md create mode 100644 src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md create mode 100644 src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md create mode 100644 src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md create mode 100644 src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md create mode 100644 src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md diff --git a/src/pages/graphql/schema/product-alert/index.md b/src/pages/graphql/schema/product-alert/index.md new file mode 100644 index 000000000..f1f5d79d1 --- /dev/null +++ b/src/pages/graphql/schema/product-alert/index.md @@ -0,0 +1,35 @@ +--- +title: Product alerts +description: Use product alert mutations and queries to manage stock and price alert subscriptions for logged-in customers. +--- + +# Product alerts + +Product alerts allow logged-in customers to subscribe to receive notifications when a product's price drops or when an out-of-stock product becomes available again. + +These mutations and queries require a valid [customer authentication token](../customer/mutations/generate-token.md). + + + +These mutations and queries were created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and are now available on Adobe Commerce 2.4.9. + +## Mutations + +- [subscribeProductAlertStock mutation](mutations/subscribe-stock.md) — Subscribe to a back-in-stock alert for a product. +- [unsubscribeProductAlertStock mutation](mutations/unsubscribe-stock.md) — Unsubscribe from a back-in-stock alert for a product. +- [unsubscribeProductAlertStockAll mutation](mutations/unsubscribe-stock-all.md) — Unsubscribe from all back-in-stock alerts. +- [subscribeProductAlertPrice mutation](mutations/subscribe-price.md) — Subscribe to a price-drop alert for a product. +- [unsubscribeProductAlertPrice mutation](mutations/unsubscribe-price.md) — Unsubscribe from a price-drop alert for a product. +- [unsubscribeProductAlertPriceAll mutation](mutations/unsubscribe-price-all.md) — Unsubscribe from all price-drop alerts. + +## Queries + +- [isSubscribedProductAlertStock query](queries/is-subscribed-stock.md) — Check whether the logged-in customer is subscribed to a back-in-stock alert for a product. +- [isSubscribedProductAlertPrice query](queries/is-subscribed-price.md) — Check whether the logged-in customer is subscribed to a price-drop alert for a product. + +## Prerequisites + +Product alerts must be enabled in the Admin before these operations are available: + +- **Stores** > **Configuration** > **Catalog** > **Product Alerts** > **Allow Alert When Product Price Changes** — enables price alerts. +- **Stores** > **Configuration** > **Catalog** > **Product Alerts** > **Allow Alert When Product Comes Back in Stock** — enables stock alerts. diff --git a/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md b/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md new file mode 100644 index 000000000..84786d81c --- /dev/null +++ b/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md @@ -0,0 +1,78 @@ +--- +title: subscribeProductAlertPrice mutation +description: The subscribeProductAlertPrice mutation subscribes a logged-in customer to a price-drop alert for a product. +--- + +# subscribeProductAlertPrice mutation + +The `subscribeProductAlertPrice` mutation subscribes the logged-in customer to a price-drop alert for the specified product. When the product's price decreases, the customer receives an email notification. + +This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + + +This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. + +## Syntax + +```graphql +mutation { + subscribeProductAlertPrice(input: ProductAlertPriceInput!) { + success + message + } +} +``` + +## Example usage + +The following example subscribes the logged-in customer to a price-drop alert for a product with SKU `MH01-XS-Black`. + +**Request:** + +```graphql +mutation { + subscribeProductAlertPrice(input: { sku: "MH01-XS-Black" }) { + success + message + } +} +``` + +**Response:** + +```json +{ + "data": { + "subscribeProductAlertPrice": { + "success": true, + "message": "You saved the alert subscription." + } + } +} +``` + +## Input attributes + +The `ProductAlertPriceInput` object contains the following attribute: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `sku` | String! | The SKU of the product to subscribe to price-drop alerts for. | + +## Output attributes + +The `ProductAlertSubscriptionResult` object contains the following attributes: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `success` | Boolean! | Indicates whether the subscription was successful. | +| `message` | String | A message describing the result of the subscription action. | + +## Errors + +| Error | Description | +| --- | --- | +| `Customer is not logged in.` | The request did not include a valid customer authentication token. | +| `Required parameter "sku" is missing.` | The `sku` field was not provided in the input. | +| `Product with SKU "%1" does not exist.` | No product was found matching the provided SKU. | diff --git a/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md b/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md new file mode 100644 index 000000000..1abace667 --- /dev/null +++ b/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md @@ -0,0 +1,78 @@ +--- +title: subscribeProductAlertStock mutation +description: The subscribeProductAlertStock mutation subscribes a logged-in customer to a back-in-stock alert for a product. +--- + +# subscribeProductAlertStock mutation + +The `subscribeProductAlertStock` mutation subscribes the logged-in customer to a back-in-stock alert for the specified product. When the product becomes available, the customer receives an email notification. + +This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + + +This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. + +## Syntax + +```graphql +mutation { + subscribeProductAlertStock(input: ProductAlertStockInput!) { + success + message + } +} +``` + +## Example usage + +The following example subscribes the logged-in customer to a back-in-stock alert for a product with SKU `MH01-XS-Black`. + +**Request:** + +```graphql +mutation { + subscribeProductAlertStock(input: { sku: "MH01-XS-Black" }) { + success + message + } +} +``` + +**Response:** + +```json +{ + "data": { + "subscribeProductAlertStock": { + "success": true, + "message": "You saved the alert subscription." + } + } +} +``` + +## Input attributes + +The `ProductAlertStockInput` object contains the following attribute: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `sku` | String! | The SKU of the product to subscribe to back-in-stock alerts for. | + +## Output attributes + +The `ProductAlertSubscriptionResult` object contains the following attributes: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `success` | Boolean! | Indicates whether the subscription was successful. | +| `message` | String | A message describing the result of the subscription action. | + +## Errors + +| Error | Description | +| --- | --- | +| `Customer is not logged in.` | The request did not include a valid customer authentication token. | +| `Required parameter "sku" is missing.` | The `sku` field was not provided in the input. | +| `Product with SKU "%1" does not exist.` | No product was found matching the provided SKU. | diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md new file mode 100644 index 000000000..b9cf06a77 --- /dev/null +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md @@ -0,0 +1,68 @@ +--- +title: unsubscribeProductAlertPriceAll mutation +description: The unsubscribeProductAlertPriceAll mutation removes all of a logged-in customer's price-drop alert subscriptions. +--- + +# unsubscribeProductAlertPriceAll mutation + +The `unsubscribeProductAlertPriceAll` mutation removes all of the logged-in customer's price-drop alert subscriptions in a single operation. + +This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + + +This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. + +## Syntax + +```graphql +mutation { + unsubscribeProductAlertPriceAll { + success + message + } +} +``` + +## Example usage + +The following example removes all price-drop alert subscriptions for the logged-in customer. + +**Request:** + +```graphql +mutation { + unsubscribeProductAlertPriceAll { + success + message + } +} +``` + +**Response:** + +```json +{ + "data": { + "unsubscribeProductAlertPriceAll": { + "success": true, + "message": "You will no longer receive price alerts." + } + } +} +``` + +## Output attributes + +The `ProductAlertSubscriptionResult` object contains the following attributes: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `success` | Boolean! | Indicates whether the operation was successful. | +| `message` | String | A message describing the result of the operation. | + +## Errors + +| Error | Description | +| --- | --- | +| `Customer is not logged in.` | The request did not include a valid customer authentication token. | diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md new file mode 100644 index 000000000..3f4c52d22 --- /dev/null +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md @@ -0,0 +1,78 @@ +--- +title: unsubscribeProductAlertPrice mutation +description: The unsubscribeProductAlertPrice mutation removes a logged-in customer's price-drop alert subscription for a product. +--- + +# unsubscribeProductAlertPrice mutation + +The `unsubscribeProductAlertPrice` mutation removes the logged-in customer's price-drop alert subscription for the specified product. + +This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + + +This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. + +## Syntax + +```graphql +mutation { + unsubscribeProductAlertPrice(input: ProductAlertPriceInput!) { + success + message + } +} +``` + +## Example usage + +The following example removes the logged-in customer's price-drop alert subscription for a product with SKU `MH01-XS-Black`. + +**Request:** + +```graphql +mutation { + unsubscribeProductAlertPrice(input: { sku: "MH01-XS-Black" }) { + success + message + } +} +``` + +**Response:** + +```json +{ + "data": { + "unsubscribeProductAlertPrice": { + "success": true, + "message": "You saved the alert subscription." + } + } +} +``` + +## Input attributes + +The `ProductAlertPriceInput` object contains the following attribute: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `sku` | String! | The SKU of the product to unsubscribe from price-drop alerts for. | + +## Output attributes + +The `ProductAlertSubscriptionResult` object contains the following attributes: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `success` | Boolean! | Indicates whether the unsubscription was successful. | +| `message` | String | A message describing the result of the unsubscription action. | + +## Errors + +| Error | Description | +| --- | --- | +| `Customer is not logged in.` | The request did not include a valid customer authentication token. | +| `Required parameter "sku" is missing.` | The `sku` field was not provided in the input. | +| `Product with SKU "%1" does not exist.` | No product was found matching the provided SKU. | diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md new file mode 100644 index 000000000..a4f3fcae5 --- /dev/null +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md @@ -0,0 +1,68 @@ +--- +title: unsubscribeProductAlertStockAll mutation +description: The unsubscribeProductAlertStockAll mutation removes all of a logged-in customer's back-in-stock alert subscriptions. +--- + +# unsubscribeProductAlertStockAll mutation + +The `unsubscribeProductAlertStockAll` mutation removes all of the logged-in customer's back-in-stock alert subscriptions in a single operation. + +This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + + +This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. + +## Syntax + +```graphql +mutation { + unsubscribeProductAlertStockAll { + success + message + } +} +``` + +## Example usage + +The following example removes all back-in-stock alert subscriptions for the logged-in customer. + +**Request:** + +```graphql +mutation { + unsubscribeProductAlertStockAll { + success + message + } +} +``` + +**Response:** + +```json +{ + "data": { + "unsubscribeProductAlertStockAll": { + "success": true, + "message": "You will no longer receive stock alerts." + } + } +} +``` + +## Output attributes + +The `ProductAlertSubscriptionResult` object contains the following attributes: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `success` | Boolean! | Indicates whether the operation was successful. | +| `message` | String | A message describing the result of the operation. | + +## Errors + +| Error | Description | +| --- | --- | +| `Customer is not logged in.` | The request did not include a valid customer authentication token. | diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md new file mode 100644 index 000000000..478fd69ab --- /dev/null +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md @@ -0,0 +1,78 @@ +--- +title: unsubscribeProductAlertStock mutation +description: The unsubscribeProductAlertStock mutation removes a logged-in customer's back-in-stock alert subscription for a product. +--- + +# unsubscribeProductAlertStock mutation + +The `unsubscribeProductAlertStock` mutation removes the logged-in customer's back-in-stock alert subscription for the specified product. + +This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + + +This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. + +## Syntax + +```graphql +mutation { + unsubscribeProductAlertStock(input: ProductAlertStockInput!) { + success + message + } +} +``` + +## Example usage + +The following example removes the logged-in customer's back-in-stock alert subscription for a product with SKU `MH01-XS-Black`. + +**Request:** + +```graphql +mutation { + unsubscribeProductAlertStock(input: { sku: "MH01-XS-Black" }) { + success + message + } +} +``` + +**Response:** + +```json +{ + "data": { + "unsubscribeProductAlertStock": { + "success": true, + "message": "You saved the alert subscription." + } + } +} +``` + +## Input attributes + +The `ProductAlertStockInput` object contains the following attribute: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `sku` | String! | The SKU of the product to unsubscribe from back-in-stock alerts for. | + +## Output attributes + +The `ProductAlertSubscriptionResult` object contains the following attributes: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `success` | Boolean! | Indicates whether the unsubscription was successful. | +| `message` | String | A message describing the result of the unsubscription action. | + +## Errors + +| Error | Description | +| --- | --- | +| `Customer is not logged in.` | The request did not include a valid customer authentication token. | +| `Required parameter "sku" is missing.` | The `sku` field was not provided in the input. | +| `Product with SKU "%1" does not exist.` | No product was found matching the provided SKU. | diff --git a/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md b/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md new file mode 100644 index 000000000..6602ba41d --- /dev/null +++ b/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md @@ -0,0 +1,78 @@ +--- +title: isSubscribedProductAlertPrice query +description: The isSubscribedProductAlertPrice query checks whether the logged-in customer is subscribed to a price-drop alert for a product. +--- + +# isSubscribedProductAlertPrice query + +The `isSubscribedProductAlertPrice` query returns whether the logged-in customer is currently subscribed to a price-drop alert for the specified product. + +This query requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + + +This query was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. + +## Syntax + +```graphql +query { + isSubscribedProductAlertPrice(input: ProductAlertPriceInput!) { + isSubscribed + message + } +} +``` + +## Example usage + +The following example checks whether the logged-in customer is subscribed to a price-drop alert for a product with SKU `MH01-XS-Black`. + +**Request:** + +```graphql +query { + isSubscribedProductAlertPrice(input: { sku: "MH01-XS-Black" }) { + isSubscribed + message + } +} +``` + +**Response:** + +```json +{ + "data": { + "isSubscribedProductAlertPrice": { + "isSubscribed": false, + "message": "You are not subscribed to this product." + } + } +} +``` + +## Input attributes + +The `ProductAlertPriceInput` object contains the following attribute: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `sku` | String! | The SKU of the product to check the price-drop alert subscription status for. | + +## Output attributes + +The `IsProductAlertSubscriptionResult` object contains the following attributes: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `isSubscribed` | Boolean! | Indicates whether the customer is currently subscribed to a price-drop alert for the product. | +| `message` | String | A message describing the current subscription status. | + +## Errors + +| Error | Description | +| --- | --- | +| `Customer is not logged in.` | The request did not include a valid customer authentication token. | +| `Required parameter "sku" is missing.` | The `sku` field was not provided in the input. | +| `Product with SKU "%1" does not exist.` | No product was found matching the provided SKU. | diff --git a/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md b/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md new file mode 100644 index 000000000..553fea8dd --- /dev/null +++ b/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md @@ -0,0 +1,78 @@ +--- +title: isSubscribedProductAlertStock query +description: The isSubscribedProductAlertStock query checks whether the logged-in customer is subscribed to a back-in-stock alert for a product. +--- + +# isSubscribedProductAlertStock query + +The `isSubscribedProductAlertStock` query returns whether the logged-in customer is currently subscribed to a back-in-stock alert for the specified product. + +This query requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + + +This query was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. + +## Syntax + +```graphql +query { + isSubscribedProductAlertStock(input: ProductAlertStockInput!) { + isSubscribed + message + } +} +``` + +## Example usage + +The following example checks whether the logged-in customer is subscribed to a back-in-stock alert for a product with SKU `MH01-XS-Black`. + +**Request:** + +```graphql +query { + isSubscribedProductAlertStock(input: { sku: "MH01-XS-Black" }) { + isSubscribed + message + } +} +``` + +**Response:** + +```json +{ + "data": { + "isSubscribedProductAlertStock": { + "isSubscribed": true, + "message": "You are already subscribed to this product." + } + } +} +``` + +## Input attributes + +The `ProductAlertStockInput` object contains the following attribute: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `sku` | String! | The SKU of the product to check the back-in-stock alert subscription status for. | + +## Output attributes + +The `IsProductAlertSubscriptionResult` object contains the following attributes: + +| Attribute | Data type | Description | +| --- | --- | --- | +| `isSubscribed` | Boolean! | Indicates whether the customer is currently subscribed to a back-in-stock alert for the product. | +| `message` | String | A message describing the current subscription status. | + +## Errors + +| Error | Description | +| --- | --- | +| `Customer is not logged in.` | The request did not include a valid customer authentication token. | +| `Required parameter "sku" is missing.` | The `sku` field was not provided in the input. | +| `Product with SKU "%1" does not exist.` | No product was found matching the provided SKU. | From 79a5efb5123733733132f5ba14c9e46f59627e11 Mon Sep 17 00:00:00 2001 From: Russ Johnson Date: Mon, 3 Aug 2026 14:22:24 +0200 Subject: [PATCH 2/5] USF-4239: add product alert GraphQL mutations and queries documentation --- src/pages/graphql/schema/product-alert/mutations/index.md | 8 ++++++++ src/pages/graphql/schema/product-alert/queries/index.md | 8 ++++++++ 2 files changed, 16 insertions(+) create mode 100644 src/pages/graphql/schema/product-alert/mutations/index.md create mode 100644 src/pages/graphql/schema/product-alert/queries/index.md diff --git a/src/pages/graphql/schema/product-alert/mutations/index.md b/src/pages/graphql/schema/product-alert/mutations/index.md new file mode 100644 index 000000000..e22f3a9ed --- /dev/null +++ b/src/pages/graphql/schema/product-alert/mutations/index.md @@ -0,0 +1,8 @@ +--- +title: Product alert mutations +description: The product alert mutations allow logged-in customers to subscribe to and unsubscribe from back-in-stock and price-drop alerts for products. +--- + +# Product alert mutations + +The product alert mutations allow logged-in customers to subscribe to and unsubscribe from back-in-stock and price-drop alerts for products. diff --git a/src/pages/graphql/schema/product-alert/queries/index.md b/src/pages/graphql/schema/product-alert/queries/index.md new file mode 100644 index 000000000..3d60ec2e4 --- /dev/null +++ b/src/pages/graphql/schema/product-alert/queries/index.md @@ -0,0 +1,8 @@ +--- +title: Product alert queries +description: The product alert queries allow logged-in customers to check their current back-in-stock and price-drop alert subscriptions for products. +--- + +# Product alert queries + +The product alert queries allow logged-in customers to check their current back-in-stock and price-drop alert subscriptions for products. From c9eb198c0eafbf476ec9e7eb7c83b9a06b6bfb8a Mon Sep 17 00:00:00 2001 From: Russ Johnson Date: Mon, 3 Aug 2026 14:42:02 +0200 Subject: [PATCH 3/5] USF-4239: add product alert GraphQL mutations and queries documentation --- src/pages/graphql/schema/product-alert/index.md | 4 ---- .../graphql/schema/product-alert/mutations/subscribe-price.md | 4 ---- .../graphql/schema/product-alert/mutations/subscribe-stock.md | 4 ---- .../schema/product-alert/mutations/unsubscribe-price-all.md | 4 ---- .../schema/product-alert/mutations/unsubscribe-price.md | 4 ---- .../schema/product-alert/mutations/unsubscribe-stock-all.md | 4 ---- .../schema/product-alert/mutations/unsubscribe-stock.md | 4 ---- .../schema/product-alert/queries/is-subscribed-price.md | 4 ---- .../schema/product-alert/queries/is-subscribed-stock.md | 4 ---- 9 files changed, 36 deletions(-) diff --git a/src/pages/graphql/schema/product-alert/index.md b/src/pages/graphql/schema/product-alert/index.md index f1f5d79d1..f21768314 100644 --- a/src/pages/graphql/schema/product-alert/index.md +++ b/src/pages/graphql/schema/product-alert/index.md @@ -9,10 +9,6 @@ Product alerts allow logged-in customers to subscribe to receive notifications w These mutations and queries require a valid [customer authentication token](../customer/mutations/generate-token.md). - - -These mutations and queries were created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and are now available on Adobe Commerce 2.4.9. - ## Mutations - [subscribeProductAlertStock mutation](mutations/subscribe-stock.md) — Subscribe to a back-in-stock alert for a product. diff --git a/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md b/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md index 84786d81c..55f925549 100644 --- a/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md +++ b/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md @@ -9,10 +9,6 @@ The `subscribeProductAlertPrice` mutation subscribes the logged-in customer to a This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). - - -This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. - ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md b/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md index 1abace667..f8a130260 100644 --- a/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md +++ b/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md @@ -9,10 +9,6 @@ The `subscribeProductAlertStock` mutation subscribes the logged-in customer to a This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). - - -This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. - ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md index b9cf06a77..8e10133ab 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md @@ -9,10 +9,6 @@ The `unsubscribeProductAlertPriceAll` mutation removes all of the logged-in cust This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). - - -This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. - ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md index 3f4c52d22..351df7bea 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md @@ -9,10 +9,6 @@ The `unsubscribeProductAlertPrice` mutation removes the logged-in customer's pri This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). - - -This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. - ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md index a4f3fcae5..229beb9da 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md @@ -9,10 +9,6 @@ The `unsubscribeProductAlertStockAll` mutation removes all of the logged-in cust This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). - - -This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. - ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md index 478fd69ab..9ff7d5199 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md @@ -9,10 +9,6 @@ The `unsubscribeProductAlertStock` mutation removes the logged-in customer's bac This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). - - -This mutation was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. - ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md b/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md index 6602ba41d..21e581cb9 100644 --- a/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md +++ b/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md @@ -9,10 +9,6 @@ The `isSubscribedProductAlertPrice` query returns whether the logged-in customer This query requires a valid [customer authentication token](../../customer/mutations/generate-token.md). - - -This query was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. - ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md b/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md index 553fea8dd..142d44848 100644 --- a/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md +++ b/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md @@ -9,10 +9,6 @@ The `isSubscribedProductAlertStock` query returns whether the logged-in customer This query requires a valid [customer authentication token](../../customer/mutations/generate-token.md). - - -This query was created for the [Storefront Compatibility Package](https://experienceleague.adobe.com/developer/commerce/storefront/setup/configuration/storefront-compatibility/v248/) and is now available on Adobe Commerce 2.4.9. - ## Syntax ```graphql From ce26027cb48673edcc5f42a38b208f5cdc324a9a Mon Sep 17 00:00:00 2001 From: Russ Johnson Date: Mon, 3 Aug 2026 14:48:42 +0200 Subject: [PATCH 4/5] USF-4239: add product alert GraphQL mutations and queries documentation --- .../graphql/schema/product-alert/mutations/subscribe-price.md | 2 ++ .../graphql/schema/product-alert/mutations/subscribe-stock.md | 2 ++ .../schema/product-alert/mutations/unsubscribe-price-all.md | 2 ++ .../graphql/schema/product-alert/mutations/unsubscribe-price.md | 2 ++ .../schema/product-alert/mutations/unsubscribe-stock-all.md | 2 ++ .../graphql/schema/product-alert/mutations/unsubscribe-stock.md | 2 ++ .../graphql/schema/product-alert/queries/is-subscribed-price.md | 2 ++ .../graphql/schema/product-alert/queries/is-subscribed-stock.md | 2 ++ 8 files changed, 16 insertions(+) diff --git a/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md b/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md index 55f925549..b72e4da98 100644 --- a/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md +++ b/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md @@ -9,6 +9,8 @@ The `subscribeProductAlertPrice` mutation subscribes the logged-in customer to a This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). +This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). + ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md b/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md index f8a130260..0e093f7ac 100644 --- a/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md +++ b/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md @@ -9,6 +9,8 @@ The `subscribeProductAlertStock` mutation subscribes the logged-in customer to a This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). +This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). + ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md index 8e10133ab..884989047 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md @@ -9,6 +9,8 @@ The `unsubscribeProductAlertPriceAll` mutation removes all of the logged-in cust This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). +This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). + ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md index 351df7bea..038954466 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md @@ -9,6 +9,8 @@ The `unsubscribeProductAlertPrice` mutation removes the logged-in customer's pri This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). +This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). + ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md index 229beb9da..2dd4cb09d 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md @@ -9,6 +9,8 @@ The `unsubscribeProductAlertStockAll` mutation removes all of the logged-in cust This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). +This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). + ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md index 9ff7d5199..0b4f7a20f 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md @@ -9,6 +9,8 @@ The `unsubscribeProductAlertStock` mutation removes the logged-in customer's bac This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). +This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). + ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md b/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md index 21e581cb9..32faa3b0c 100644 --- a/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md +++ b/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md @@ -9,6 +9,8 @@ The `isSubscribedProductAlertPrice` query returns whether the logged-in customer This query requires a valid [customer authentication token](../../customer/mutations/generate-token.md). +This query is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). + ## Syntax ```graphql diff --git a/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md b/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md index 142d44848..b431baf73 100644 --- a/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md +++ b/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md @@ -9,6 +9,8 @@ The `isSubscribedProductAlertStock` query returns whether the logged-in customer This query requires a valid [customer authentication token](../../customer/mutations/generate-token.md). +This query is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). + ## Syntax ```graphql From 68cc593b51de720b8e3dc220b5ac135d5b648ebc Mon Sep 17 00:00:00 2001 From: Russ Johnson Date: Mon, 3 Aug 2026 14:51:05 +0200 Subject: [PATCH 5/5] USF-4239: add product alert GraphQL mutations and queries documentation --- .../graphql/schema/product-alert/mutations/subscribe-price.md | 2 ++ .../graphql/schema/product-alert/mutations/subscribe-stock.md | 2 ++ .../schema/product-alert/mutations/unsubscribe-price-all.md | 2 ++ .../graphql/schema/product-alert/mutations/unsubscribe-price.md | 2 ++ .../schema/product-alert/mutations/unsubscribe-stock-all.md | 2 ++ .../graphql/schema/product-alert/mutations/unsubscribe-stock.md | 2 ++ .../graphql/schema/product-alert/queries/is-subscribed-price.md | 2 ++ .../graphql/schema/product-alert/queries/is-subscribed-stock.md | 2 ++ 8 files changed, 16 insertions(+) diff --git a/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md b/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md index b72e4da98..4317fae5c 100644 --- a/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md +++ b/src/pages/graphql/schema/product-alert/mutations/subscribe-price.md @@ -9,6 +9,8 @@ The `subscribeProductAlertPrice` mutation subscribes the logged-in customer to a This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). ## Syntax diff --git a/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md b/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md index 0e093f7ac..689c526c2 100644 --- a/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md +++ b/src/pages/graphql/schema/product-alert/mutations/subscribe-stock.md @@ -9,6 +9,8 @@ The `subscribeProductAlertStock` mutation subscribes the logged-in customer to a This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). ## Syntax diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md index 884989047..3111db4e0 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price-all.md @@ -9,6 +9,8 @@ The `unsubscribeProductAlertPriceAll` mutation removes all of the logged-in cust This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). ## Syntax diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md index 038954466..4b75aed40 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-price.md @@ -9,6 +9,8 @@ The `unsubscribeProductAlertPrice` mutation removes the logged-in customer's pri This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). ## Syntax diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md index 2dd4cb09d..cba79ef53 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock-all.md @@ -9,6 +9,8 @@ The `unsubscribeProductAlertStockAll` mutation removes all of the logged-in cust This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). ## Syntax diff --git a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md index 0b4f7a20f..d96045bc1 100644 --- a/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md +++ b/src/pages/graphql/schema/product-alert/mutations/unsubscribe-stock.md @@ -9,6 +9,8 @@ The `unsubscribeProductAlertStock` mutation removes the logged-in customer's bac This mutation requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + This mutation is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). ## Syntax diff --git a/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md b/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md index 32faa3b0c..4c1077653 100644 --- a/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md +++ b/src/pages/graphql/schema/product-alert/queries/is-subscribed-price.md @@ -9,6 +9,8 @@ The `isSubscribedProductAlertPrice` query returns whether the logged-in customer This query requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + This query is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). ## Syntax diff --git a/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md b/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md index b431baf73..4a1c33dbe 100644 --- a/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md +++ b/src/pages/graphql/schema/product-alert/queries/is-subscribed-stock.md @@ -9,6 +9,8 @@ The `isSubscribedProductAlertStock` query returns whether the logged-in customer This query requires a valid [customer authentication token](../../customer/mutations/generate-token.md). + + This query is part of the Storefront Compatibility Package and is only available on [Adobe Commerce as a Cloud Service](https://experienceleague.adobe.com/en/docs/commerce/cloud-service/overview) and [PaaS(With ACO License)](https://experienceleague.adobe.com/en/docs/commerce/optimizer/get-started). ## Syntax