From d4c57c5b7ceb1e9e371dbc74bbca66be2856ce96 Mon Sep 17 00:00:00 2001
From: dylandepass <3231084+dylandepass@users.noreply.github.com>
Date: Tue, 15 Sep 2026 15:03:04 +0000
Subject: [PATCH] docs: sync with
 helix-commerce-api@c8a516fa37a3f90981679aee7edbf376cd48ad5c

---
 docs/api-reference.md            | 10 +++++++---
 docs/authentication-setup.md     |  2 +-
 docs/authentication.md           |  2 +-
 docs/checkout.md                 |  2 +-
 docs/coupons.md                  | 14 ++++++++++----
 docs/customers.md                | 17 ++++++++++++++---
 docs/data-ingestion.md           |  2 +-
 docs/emails.md                   |  2 +-
 docs/estimates.md                |  2 +-
 docs/fraud-forter.md             |  2 +-
 docs/getting-started.md          |  2 +-
 docs/identity-idme.md            |  2 +-
 docs/indexing.md                 |  2 +-
 docs/network.md                  |  2 +-
 docs/order-journal.md            |  8 ++++----
 docs/order-lifecycle.md          |  2 +-
 docs/overview.md                 |  2 +-
 docs/payments-affirm.md          |  2 +-
 docs/payments-apple-pay.md       |  2 +-
 docs/payments-chase.md           |  2 +-
 docs/payments-paypal.md          |  2 +-
 docs/payments.md                 |  2 +-
 docs/paypal-order-review.md      |  2 +-
 docs/places.md                   |  2 +-
 docs/product-catalog-modeling.md |  2 +-
 docs/promotions.md               | 21 ++++++++++++---------
 docs/recaptcha.md                |  2 +-
 docs/rendering-guide.md          |  2 +-
 docs/roles-permissions.md        |  4 ++--
 docs/schema-reference.md         |  2 +-
 docs/secrets.md                  |  2 +-
 docs/service-tokens.md           |  2 +-
 docs/site-configuration.md       |  2 +-
 docs/tax-avalara.md              |  2 +-
 34 files changed, 77 insertions(+), 53 deletions(-)

diff --git a/docs/api-reference.md b/docs/api-reference.md
index 981ebf1..1e882fb 100644
--- a/docs/api-reference.md
+++ b/docs/api-reference.md
@@ -9,8 +9,8 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
-    lastContentCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
+    lastContentCommit: "c8a516f"
   helix-mixer:
     version: "v1.6.1"
     lastReviewedCommit: "b8acff4"
@@ -345,8 +345,10 @@ Learn more about [image handling](/schema-reference#productbusmedia) in the sche
 
 To delete products, send the bulk request with `?delete=true`. Each item must be an object containing an extensionless product `path`. Deletes are unconditional and duplicate paths are processed once. The API validates all items before deleting anything.
 
+Use `?forceUpdate=true` with bulk deletion to emit an index-removal event for each item that returns `404` because the product is already absent from the catalog. This can clear an orphaned index entry. The request body may include `forceUpdate: true` as an alias; if both the query parameter and body field are provided, they must have the same value.
+
 ```bash
-curl "https://api.adobecommerce.live/{org}/sites/{site}/catalog?delete=true" \
+curl "https://api.adobecommerce.live/{org}/sites/{site}/catalog?delete=true&forceUpdate=true" \
   -X POST \
   -H "Authorization: Bearer {your-api-key}" \
   -H "Content-Type: application/json" \
@@ -384,6 +386,8 @@ curl -i "https://api.adobecommerce.live/{org}/sites/{site}/catalog/us/en/product
 
 This endpoint requires authentication. A successful deletion returns `204 No Content`. If the product doesn't exist at the specified path, you'll receive a `404 Not Found` response. You can send `If-Match` or `If-None-Match` to conditionally delete the product. A failed precondition returns `412 Precondition Failed`, and the product remains in place.
 
+A single `DELETE` always emits an index-removal event, including when the product already returns `404`, so repeating a delete can clear an orphaned index entry. This behavior does not occur when a conditional request fails with `412 Precondition Failed`.
+
 ```bash
 curl -X DELETE \
   -H "Authorization: Bearer {your-api-key}" \
diff --git a/docs/authentication-setup.md b/docs/authentication-setup.md
index 8583beb..d53611a 100644
--- a/docs/authentication-setup.md
+++ b/docs/authentication-setup.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.62.0"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "6fb1e2b"
 ---
 
diff --git a/docs/authentication.md b/docs/authentication.md
index 3437de7..eabcfda 100644
--- a/docs/authentication.md
+++ b/docs/authentication.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "59379a6"
 ---
 
diff --git a/docs/checkout.md b/docs/checkout.md
index b3babbb..702017d 100644
--- a/docs/checkout.md
+++ b/docs/checkout.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.3"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "59379a6"
 ---
 
diff --git a/docs/coupons.md b/docs/coupons.md
index 4850e8a..663118f 100644
--- a/docs/coupons.md
+++ b/docs/coupons.md
@@ -8,8 +8,8 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
-    lastContentCommit: "844b959"
+    lastReviewedCommit: "c8a516f"
+    lastContentCommit: "c8a516f"
 migration:
   from: "helix-commerce-documentation/documentation/coupons.md"
   migratedAt: "2026-06-15"
@@ -72,6 +72,12 @@ To retrieve, update, or delete a type, use `GET`, `PUT`, or `DELETE` at `/{org}/
 | `defaultUsesPerCode` | number | No | Default `usesPerCustomer` applied to codes created under this type |
 | `notes` | string | No | Internal notes. Not surfaced to customers |
 
+### Category eligibility
+
+Category scope is resolved from the authoritative product entry associated with each cart line's product path. The API does not rely only on category data supplied in the cart request. When a coupon uses `includedCategories` or `excludedCategories`, the estimate flow retrieves the product data needed to evaluate the product's categories.
+
+Product-level scope takes precedence over category-level scope. If product include or exclude conditions are present, they determine eligibility for the line; category conditions do not override that product-level decision. Within either scope level, exclusions take precedence over inclusions.
+
 ### Discount calculation
 
 For `"percentage"` discount types, the discount is `(eligibleSubtotal × discountValue) / 100`, capped at `maximumDiscountAmount` when set. For `"fixed"` discount types, the discount is the lesser of `discountValue` and the eligible subtotal, ensuring the subtotal never goes negative.
@@ -174,7 +180,7 @@ curl "https://api.adobecommerce.live/{org}/sites/{site}/coupons?active=true" \
   -H "Authorization: Bearer {your-api-key}"
 ```
 
-The response includes a `cursor` field for pagination. Pass `cursor` as a query parameter in the next request to retrieve the following page.
+The optional `limit` query parameter controls the number of codes returned per page. It defaults to `100` and is clamped to the range `1`–`1000`. The response includes a `cursor` field when more results are available; pass that cursor as a query parameter in the next request to retrieve the following page.
 
 ### Code format and tracking suffixes
 
@@ -243,4 +249,4 @@ After a successful order payment, the system asynchronously increments `usageCou
 
 - [Promotions guide](/promotions): Set up automatic catalog and cart discounts that apply without a code
 - [Rendering guide](/rendering-guide#catalog-price-rules): How promotions affect rendered product pages and indexes
-- [API reference](/api-reference): Complete API endpoint reference
+- [API reference](/api-reference): Complete API endpoint reference
\ No newline at end of file
diff --git a/docs/customers.md b/docs/customers.md
index 1a6b2d3..0058cc9 100644
--- a/docs/customers.md
+++ b/docs/customers.md
@@ -8,8 +8,8 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
-    lastContentCommit: "05b753f"
+    lastReviewedCommit: "c8a516f"
+    lastContentCommit: "c8a516f"
 ---
 
 # Customers and account data
@@ -46,6 +46,17 @@ When checkout finds an existing profile, it preserves the profile's existing val
 | List a customer's orders | `GET /{org}/sites/{site}/customers/{email}/orders` | `orders:read` and authenticated user matching `{email}` |
 | Retrieve one customer order | `GET /{org}/sites/{site}/customers/{email}/orders/{orderId}` | Optional bearer token. Email plus order ID is used for guest order-status lookup |
 
+### List customers
+
+The customer collection supports cursor-based pagination. Use the optional `limit` query parameter to set the maximum number of customers returned per page. The default is `100`; values are clamped to the range `1`–`1000`.
+
+When more customers are available, the response includes an opaque `cursor`. Pass that cursor in the next request's `cursor` query parameter to retrieve the next page.
+
+```bash
+curl "https://api.adobecommerce.live/{org}/sites/{site}/customers?limit=100&cursor={cursor}" \
+  -H "Authorization: Bearer {your-service-token-or-admin-token}"
+```
+
 ## Customer profile shape
 
 A customer profile contains checkout contact information and optional site-specific custom attributes. Custom attributes are string-valued and can store site-specific data such as a marketing opt-in, preferred contact method, or consent timestamp. See [Schema reference](/schema-reference#customer) for the generated schema.
@@ -58,7 +69,7 @@ A customer profile contains checkout contact information and optional site-speci
 | `phone` | No | Customer phone number |
 | `custom` | No | Site-specific customer attributes with string values |
 
-The API adds timestamps when the profile is stored.
+The API adds timestamps when the profile is stored. Customer phone numbers are normalized to digits-only when stored. The stored customer metadata also mirrors `firstName`, `lastName`, and `phone` for downstream customer-data consumers.
 
 ## Customer passwords
 
diff --git a/docs/data-ingestion.md b/docs/data-ingestion.md
index 1709ea6..747df18 100644
--- a/docs/data-ingestion.md
+++ b/docs/data-ingestion.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "1c6fd97"
   helix-mixer:
     version: "v1.6.1"
diff --git a/docs/emails.md b/docs/emails.md
index 4231cf2..d2c9a03 100644
--- a/docs/emails.md
+++ b/docs/emails.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.56.0"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "fc749dd"
 ---
 
diff --git a/docs/estimates.md b/docs/estimates.md
index 453e78c..02d5327 100644
--- a/docs/estimates.md
+++ b/docs/estimates.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "8f53823"
 ---
 
diff --git a/docs/fraud-forter.md b/docs/fraud-forter.md
index 8fb0aed..308d145 100644
--- a/docs/fraud-forter.md
+++ b/docs/fraud-forter.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "e77382f"
 ---
 
diff --git a/docs/getting-started.md b/docs/getting-started.md
index 2d6094e..163d66e 100644
--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.56.0"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "59379a6"
   helix-mixer:
     version: "v1.6.1"
diff --git a/docs/identity-idme.md b/docs/identity-idme.md
index ee1e2bc..361a435 100644
--- a/docs/identity-idme.md
+++ b/docs/identity-idme.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "fc749dd"
 ---
 
diff --git a/docs/indexing.md b/docs/indexing.md
index aa7d473..009f939 100644
--- a/docs/indexing.md
+++ b/docs/indexing.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "1c6fd97"
   helix-mixer:
     version: "v1.6.1"
diff --git a/docs/network.md b/docs/network.md
index 656a2f3..3ed05d0 100644
--- a/docs/network.md
+++ b/docs/network.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "1c6fd97"
   helix-mixer:
     version: "v1.6.1"
diff --git a/docs/order-journal.md b/docs/order-journal.md
index 12418d8..5390259 100644
--- a/docs/order-journal.md
+++ b/docs/order-journal.md
@@ -8,8 +8,8 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.56.0"
-    lastReviewedCommit: "1c6fd97"
-    lastContentCommit: "05b753f"
+    lastReviewedCommit: "c8a516f"
+    lastContentCommit: "c8a516f"
 ---
 
 # Order journal
@@ -75,7 +75,7 @@ The `payment_requires_confirmation` event is emitted when a buyer has approved a
 
 For `payment_cancelled` entries, `configuration_error` indicates that review mode could not resolve a valid review URL. `order_not_approved` indicates that express review validation found that the PayPal order was not approved or was not found. Other upstream validation failures remain retryable and do not cancel the order.
 
-Payment-cancellation journal entries contain the internal cancellation `reason` and provider diagnostics for administrative troubleshooting.
+Payment-cancellation journal entries contain the internal cancellation `reason` and provider diagnostics for administrative troubleshooting. For Chase payment declines, diagnostics can also include the provider transaction reference and, when available, the gateway processing status and status message. These values help correlate a failed attempt with the provider and identify gateway-level declines.
 
 For failed provider requests, diagnostic response bodies are limited to 512 characters and receive basic redaction for apparent bearer tokens and payment card number patterns. Treat all diagnostic response details as sensitive and do not expose them in storefronts or other customer-facing views.
 
@@ -199,4 +199,4 @@ Use the current order document for storefront state. Use the journal for debuggi
 - [Transactional email](/emails): Understand order confirmation email outcomes
 - [Payments overview](/checkout/payments/overview): Understand payment initiation and provider actions
 - [Service tokens](/authentication/service-tokens): Create read-only journal tokens
-- [API reference](/api-reference): Complete endpoint details
+- [API reference](/api-reference): Complete endpoint details
\ No newline at end of file
diff --git a/docs/order-lifecycle.md b/docs/order-lifecycle.md
index 9dad11f..41b0bc7 100644
--- a/docs/order-lifecycle.md
+++ b/docs/order-lifecycle.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "05b753f"
 ---
 
diff --git a/docs/overview.md b/docs/overview.md
index cd531b4..7a7cf9e 100644
--- a/docs/overview.md
+++ b/docs/overview.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.56.0"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "59379a6"
   helix-mixer:
     version: "v1.6.1"
diff --git a/docs/payments-affirm.md b/docs/payments-affirm.md
index 92523a3..459f867 100644
--- a/docs/payments-affirm.md
+++ b/docs/payments-affirm.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "05b753f"
 ---
 
diff --git a/docs/payments-apple-pay.md b/docs/payments-apple-pay.md
index 6cc7b03..4858f22 100644
--- a/docs/payments-apple-pay.md
+++ b/docs/payments-apple-pay.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "e77382f"
 ---
 
diff --git a/docs/payments-chase.md b/docs/payments-chase.md
index 9695884..aacf8af 100644
--- a/docs/payments-chase.md
+++ b/docs/payments-chase.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "05b753f"
 ---
 
diff --git a/docs/payments-paypal.md b/docs/payments-paypal.md
index 1f5f75f..ef24bd3 100644
--- a/docs/payments-paypal.md
+++ b/docs/payments-paypal.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "05b753f"
 ---
 
diff --git a/docs/payments.md b/docs/payments.md
index a8685f2..1269dce 100644
--- a/docs/payments.md
+++ b/docs/payments.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "05b753f"
 ---
 
diff --git a/docs/paypal-order-review.md b/docs/paypal-order-review.md
index 736387b..35c704a 100644
--- a/docs/paypal-order-review.md
+++ b/docs/paypal-order-review.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "unknown"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "05b753f"
 ---
 
diff --git a/docs/places.md b/docs/places.md
index 4143663..c0ca9ff 100644
--- a/docs/places.md
+++ b/docs/places.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "8f53823"
 ---
 
diff --git a/docs/product-catalog-modeling.md b/docs/product-catalog-modeling.md
index db0e404..d389a25 100644
--- a/docs/product-catalog-modeling.md
+++ b/docs/product-catalog-modeling.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.49.1"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "1c6fd97"
   helix-product-pipeline:
     version: "v2.9.1"
diff --git a/docs/promotions.md b/docs/promotions.md
index 1c31767..9de1ca8 100644
--- a/docs/promotions.md
+++ b/docs/promotions.md
@@ -8,8 +8,8 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
-    lastContentCommit: "d180131"
+    lastReviewedCommit: "c8a516f"
+    lastContentCommit: "c8a516f"
   helix-product-pipeline:
     version: "v2.9.1"
     lastReviewedCommit: "893adf9"
@@ -30,7 +30,7 @@ Catalog promotions define product-level price overrides grouped into named campa
 
 ### Creating and updating catalog promotions
 
-Catalog promotions are stored as a single document per site and replaced in full with each write.
+Catalog promotions are stored as a single document per site and replaced in full with each write. Updating the catalog promotions triggers an immediate cache purge, so changes become effective without waiting for normal cache expiration.
 
 ```bash
 curl -X PUT "https://api.adobecommerce.live/{org}/sites/{site}/price-rules/catalog" \
@@ -75,6 +75,7 @@ Each `CatalogPriceRule` within `rules`:
 |-------|------|----------|-------------|
 | `path` | string | Yes | Product URL path this rule applies to (e.g., `"/us/en/products/blender-pro-500"`) |
 | `price` | string | Yes | Discounted price to use when this rule is active |
+| `enabled` | boolean | No | Whether the rule can apply. Defaults to enabled; set to `false` to disable the rule |
 | `start` | string | No | ISO 8601 timestamp. Rule is inactive before this time |
 | `end` | string | No | ISO 8601 timestamp. Rule is inactive after this time |
 | `variants` | object | No | Per-SKU price overrides. Keys are variant SKUs, values are `VariantPriceRule` objects (see below) |
@@ -85,6 +86,7 @@ Each `CatalogPriceRule` within `rules`:
 |-------|------|----------|-------------|
 | `sku` | string | Yes | Variant SKU |
 | `price` | string | Yes | Discounted price for this variant |
+| `enabled` | boolean | No | Whether the variant rule can apply. Defaults to enabled; set to `false` to disable the variant rule |
 | `start` | string | No | ISO 8601 timestamp. Variant rule is inactive before this time |
 | `end` | string | No | ISO 8601 timestamp. Variant rule is inactive after this time |
 
@@ -92,7 +94,7 @@ Each `CatalogPriceRule` within `rules`:
 
 When the pipeline evaluates catalog promotions for a product, it finds the best active promotion rule for that product path across all promotions. A rule qualifies if its price is lower than the product's current `price.final` or if any of its active variant-specific prices are lower than the corresponding variants' current prices. Among qualifying rules, the one with the lowest product-level price wins.
 
-A rule is considered active when the current time falls within its optional `start`/`end` window. Rules without a `start` or `end` are always active.
+A rule is considered active when it is enabled and the current time falls within its optional `start`/`end` window. Rules without a `start` or `end` are always active. A rule is enabled unless `enabled` is explicitly `false`. The same rules apply to variant-specific price overrides.
 
 Variants not explicitly listed in `rule.variants` inherit the parent product's rule price if it is lower than their current price.
 
@@ -165,7 +167,7 @@ When a catalog promotion has a `conditions` object, it behaves differently. Rath
 
 The `conditions` object supports `minimumSubtotal` for a spending threshold, `requiredProducts` and `excludedProducts` for cart content requirements, and `requiredCategories` and `excludedCategories` for category-level requirements.
 
-Conditional promotions are never applied by the pipeline when rendering product pages or indexes. They are only evaluated at cart and checkout time, when the storefront calls the estimate endpoint and returns the qualifying free-item grants as part of the discount breakdown.
+Conditional promotions are never applied by the pipeline when rendering product pages or indexes. They are only evaluated at cart and checkout time, when the storefront calls the estimate endpoint and returns the qualifying free-item grants as part of the discount breakdown. Disabled conditional rules are not applied.
 
 ## Cart rules
 
@@ -196,10 +198,10 @@ curl -X PUT "https://api.adobecommerce.live/{org}/sites/{site}/price-rules/cart"
   ]'
 ```
 
-To read the current cart rules, use `GET` on the same endpoint. Authenticated reads return all rules. Unauthenticated reads with the `?active=true` query parameter return only currently active rules, which allows the storefront to display promotion banners without requiring API credentials.
+To read the current cart rules, use `GET` on the same endpoint. Authenticated reads return all rules. Unauthenticated reads with the `?active=true` query parameter return only currently active and enabled rules, which allows the storefront to display promotion banners without requiring API credentials.
 
 ```bash
-# Public read — returns active rules only
+# Public read — returns active and enabled rules only
 curl "https://api.adobecommerce.live/{org}/sites/{site}/price-rules/cart?active=true"
 ```
 
@@ -212,6 +214,7 @@ Each object in the array is a `CartPriceRule`:
 | `id` | string | Yes | Unique rule identifier |
 | `name` | string | Yes | Display name shown in the discount breakdown |
 | `priority` | integer | Yes | Evaluation order. Lower numbers are evaluated first |
+| `enabled` | boolean | No | Whether the rule can apply. Defaults to enabled; set to `false` to disable the rule |
 | `conditions` | object | Yes | Conditions that must be met for the rule to apply (see below) |
 | `actions` | object | Yes | Discount to apply when conditions are met (see below) |
 | `stackable` | boolean | No | Whether this rule can apply alongside other discounts (default `true`) |
@@ -246,7 +249,7 @@ At least one action must be specified.
 
 ### Stacking and priority
 
-When multiple cart rules qualify for a cart, their priority values control evaluation order. Rules with lower priority numbers are evaluated first. All stackable rules that qualify are applied; a non-stackable rule is applied alone (other rules are suppressed).
+When multiple enabled cart rules qualify for a cart, their priority values control evaluation order. Rules with lower priority numbers are evaluated first. All stackable rules that qualify are applied; a non-stackable rule is applied alone (other rules are suppressed).
 
 Cart rules that list a coupon type ID in their `incompatibleTypes` array are automatically suppressed when a coupon of that type is active. When a non-stackable coupon is applied, all cart rules are suppressed regardless of their `incompatibleTypes` setting.
 
@@ -258,4 +261,4 @@ The estimate endpoint applies each discount layer in sequence. First, catalog pr
 
 - [Coupons guide](/coupons): Create and manage coupon codes that customers enter at checkout
 - [Rendering guide](/rendering-guide#catalog-price-rules): How catalog promotions affect rendered product pages and indexes
-- [API reference](/api-reference): Complete API endpoint reference
+- [API reference](/api-reference): Complete API endpoint reference
\ No newline at end of file
diff --git a/docs/recaptcha.md b/docs/recaptcha.md
index 1f73dd2..9baabe2 100644
--- a/docs/recaptcha.md
+++ b/docs/recaptcha.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "8f53823"
 ---
 
diff --git a/docs/rendering-guide.md b/docs/rendering-guide.md
index 5e7872f..11cca49 100644
--- a/docs/rendering-guide.md
+++ b/docs/rendering-guide.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.56.0"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "1c6fd97"
   helix-mixer:
     version: "v1.6.1"
diff --git a/docs/roles-permissions.md b/docs/roles-permissions.md
index 12b6b39..71b6cb0 100644
--- a/docs/roles-permissions.md
+++ b/docs/roles-permissions.md
@@ -8,8 +8,8 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
-    lastContentCommit: "8f53823"
+    lastReviewedCommit: "c8a516f"
+    lastContentCommit: "c8a516f"
 ---
 
 # Roles and permissions
diff --git a/docs/schema-reference.md b/docs/schema-reference.md
index 98f2f9f..6d174d1 100644
--- a/docs/schema-reference.md
+++ b/docs/schema-reference.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.53.0"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "1c6fd97"
   helix-mixer:
     version: "v1.6.1"
diff --git a/docs/secrets.md b/docs/secrets.md
index cd2ea96..90fa4e4 100644
--- a/docs/secrets.md
+++ b/docs/secrets.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "b95c8fa"
 ---
 
diff --git a/docs/service-tokens.md b/docs/service-tokens.md
index 9d7e95d..d1fd4c4 100644
--- a/docs/service-tokens.md
+++ b/docs/service-tokens.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "5577796"
 ---
 
diff --git a/docs/site-configuration.md b/docs/site-configuration.md
index 9dd5046..3bbe706 100644
--- a/docs/site-configuration.md
+++ b/docs/site-configuration.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "59379a6"
 ---
 
diff --git a/docs/tax-avalara.md b/docs/tax-avalara.md
index f404631..7f0822c 100644
--- a/docs/tax-avalara.md
+++ b/docs/tax-avalara.md
@@ -8,7 +8,7 @@ sourceFormat: markdown
 sources:
   helix-commerce-api:
     version: "v2.52.2"
-    lastReviewedCommit: "1c6fd97"
+    lastReviewedCommit: "c8a516f"
     lastContentCommit: "6fb1e2b"
 ---