@salesforce/b2c-tooling-sdk 2.3.0 → 2.5.0

package/node_modules/@salesforce/b2c-api-schemas/scapi/pricing/promotions/v1.json

@@ -2,7 +2,8 @@
   "openapi": "3.0.3",
   "info": {
     "title": "Promotions",
-    "version": "1.0.36",
+    "description": "[Download API specification](https://developer.salesforce.com/static/commercecloud/commerce-api/promotions/promotions-oas-v1-public.yaml)\n\n# API Overview\n\nUse the Promotions API to create, update, delete, and search for promotion information on your site. Promotions are configured with rules that define the type of promotion, conditions, and discounts.\n\nThis API can be used to synchronize promotion data in the commerce platform with third-party promotion management systems. This API can also be called from a custom promotion management application. In sandbox environments, the Promotions API is useful for creating and updating test data, for example, with integration testing or as part of a continuous integration or continuous deployment process.\n\nFor more information, see [Campaigns and Promotions](https://help.salesforce.com/s/articleView?id=cc.b2c_campaigns_and_promotions.htm&type=5) in the B2C Commerce documentation.\n\n## Authentication & Authorization\n\nThe client requesting the promotion information must have access to the Promotion resource. For resource access, you must use a client ID and client secret from Account Manager to request an access token. The access token is used as a bearer token and added to the Authorization header of your API request. The client must first authenticate against Account Manager to log in.\n\nYou must include the relevant scope(s) in the client ID used to generate the token. For details, see [Authorization Scopes Catalog.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/auth-z-scope-catalog.html)\n\nFor detailed setup instructions, see [Authorization for Admin APIs](https://developer.salesforce.com/docs/commerce/commerce-api/guide/authorization-for-admin-apis.html).\n\n## Response Details\n\n### Timeouts\n\nAdmin API requests must respond within 60 seconds. If a response exceeds this threshold, an HTTP 504 status code is returned. For details, see [Timeouts and Limits.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/timeouts-limits.html)\n\n### Error Handling\n\nError responses follow the [RFC 7807](https://datatracker.ietf.org/doc/html/rfc7807) problem detail format. To trace errors, include a `correlation-id` header in your request — the response returns it as `x-correlation-id`. For details, see [HTTP Status Codes and Errors.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/error-response-codes.html)\n\n## Use Cases\n\n**Note**: A promotion can be created, enabled, and assigned exclusivity using the API, but qualifier and discounted criteria must be assigned in Business Manager.\n\n### Shipping Promotions\n\nUse the Promotions API to configure shipping promotions.\n\nYou can configure shipping promotions based on an order and on individual products or product combinations. You can also configure product-specific shipping cost (fixed or surcharge).\n\n**Note**: Product-related shipping discounts are considered product promotions.\n\nIn a multiple ship-to scenario, B2C Commerce determines which shipments use any of the discounted shipping methods and applies the discount from most expensive to least expensive until meeting the maximum applications limit, if specified.\n\nFor example, create a shipping promotion that gives the customer free shipping when their purchase exceeds $50.\n\nFor more detail, see [Shipping Promotions](https://help.salesforce.com/s/articleView?id=cc.b2c_shipping_promotions.htm&type=5) in the B2C Commerce documentation.\n\n### Product Promotions\n\nUse the Promotions API to configure product promotions.\n\nYou can define product promotions for specific products, groups of products or brands, or amounts of products purchased. You can define conditions that require customers to purchase from a set of products.\n\nA product promotion is prorated, calculated, and rounded once per product in the order. A product promotion is different than an order promotion, which is calculated once at the order level, and rounded off once, if necessary.\n\nFor example, create a product promotion that discounts a second item by 50% when the customer buys two.\n\nFor more detail, see [Product Promotions](https://help.salesforce.com/s/articleView?id=cc.b2c_product_promotions.htm&type=5) in the B2C Commerce documentation.\n\n### Order Promotions\n\nUse the Promotions API to configure order promotions.\n\nYou can configure order promotions for percentage discounts, fixed price discounts, and free shipping. You can offer a bonus product or a choice of bonus products, and you can tier order discounts.\n\nAn order promotion is calculated once at the order level, and rounded off once, if necessary. An order promotion is different than a product promotion, where the promotion is prorated, calculated, and rounded per product in the order.\n\nFor example, create an order promotion that discounts an entire order when the customer buys 3 qualifying items.\n\nFor more detail, see [Order Promotions](https://help.salesforce.com/s/articleView?id=cc.b2c_order_promotions.htm&type=5) in the B2C Commerce documentation.\n\n## Related APIs\n\n- [Shopper Promotions](https://developer.salesforce.com/docs/commerce/commerce-api/references/shopper-promotions?meta=Summary) — Retrieve active promotions visible to shoppers.\n- [Campaigns](https://developer.salesforce.com/docs/commerce/commerce-api/references/campaigns?meta=Summary) — Manage campaigns that group promotions.\n- [Assignments](https://developer.salesforce.com/docs/commerce/commerce-api/references/assignments?meta=Summary) — Assign promotions and discounts to campaigns.",
+    "version": "1.2.0",
     "x-api-type": "Admin",
     "x-api-family": "Pricing"
   },
@@ -11,6 +12,7 @@
       "url": "https://{shortCode}.api.commercecloud.salesforce.com/pricing/promotions/v1",
       "variables": {
         "shortCode": {
+          "description": "An eight-character string assigned to a realm for routing purposes. See [Base URL and Request Formation.](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html)",
           "default": "shortCode"
         }
       }
@@ -19,26 +21,36 @@
   "paths": {
     "/organizations/{organizationId}/promotions": {
       "post": {
+        "summary": "Search for promotions.",
+        "description": "The SearchRequest document contains a search object that allows you to filter using various attributes.\n\nUse the following searchable query attributes to narrow down the search:\n\n | Attribute | Type |\n |-----------|--------|\n | id | String |\n | name | String |\n | currecyCode |  String |\n | exclusivity |  String |\n | enabled | Boolean |\n\nNote that only searchable attributes can be used in sorting. Additionally, the following attribute can be used to\nsort:\n\n | Attribute | Type |\n |-----------|--------|\n | promotionClass | String |",
         "operationId": "promotionsSearch",
         "parameters": [
           {
             "name": "organizationId",
             "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "$ref": "#/components/schemas/OrganizationId"
-            }
+            },
+            "example": "f_ecom_zzxy_prd"
           },
           {
             "name": "siteId",
             "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
             "required": true,
             "style": "form",
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
             }
           }
         ],
@@ -63,7 +75,7 @@
             }
           },
           "400": {
-            "description": "Thrown when the query is ill-formed."
+            "description": "Returned when the query is ill-formed."
           }
         },
         "security": [
@@ -78,11 +90,13 @@
     },
     "/organizations/{organizationId}/promotions/{id}": {
       "get": {
+        "summary": "Retrieve promotion information.",
         "operationId": "getPromotion",
         "parameters": [
           {
             "name": "id",
             "in": "path",
+            "description": "The ID of the promotion to create.",
             "required": true,
             "style": "simple",
             "explode": false,
@@ -94,21 +108,29 @@
           {
             "name": "organizationId",
             "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "$ref": "#/components/schemas/OrganizationId"
-            }
+            },
+            "example": "f_ecom_zzxy_prd"
           },
           {
             "name": "siteId",
             "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
             "required": true,
             "style": "form",
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
             }
           }
         ],
@@ -119,16 +141,26 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/Promotion"
+                },
+                "examples": {
+                  "GetPromotion": {
+                    "$ref": "#/components/examples/GetPromotion"
+                  }
                 }
               }
             }
           },
           "404": {
-            "description": "Thrown when there is no promotion found for the specified ID for the requested site.",
+            "description": "Returned when there is no promotion found for the specified ID for the requested site.",
             "content": {
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "getPromotion404": {
+                    "$ref": "#/components/examples/PromotionNotFound404"
+                  }
                 }
               }
             }
@@ -144,11 +176,13 @@
         ]
       },
       "put": {
+        "summary": "Create a promotion using the information provided.",
         "operationId": "createPromotion",
         "parameters": [
           {
             "name": "id",
             "in": "path",
+            "description": "The ID of the promotion to create.",
             "required": true,
             "style": "simple",
             "explode": false,
@@ -160,21 +194,29 @@
           {
             "name": "organizationId",
             "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "$ref": "#/components/schemas/OrganizationId"
-            }
+            },
+            "example": "f_ecom_zzxy_prd"
           },
           {
             "name": "siteId",
             "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
             "required": true,
             "style": "form",
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
             }
           }
         ],
@@ -183,6 +225,11 @@
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/Promotion"
+              },
+              "examples": {
+                "PutPromotion": {
+                  "$ref": "#/components/examples/PutPromotion"
+                }
               }
             }
           }
@@ -194,16 +241,26 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/Promotion"
+                },
+                "examples": {
+                  "PutPromotion": {
+                    "$ref": "#/components/examples/examples-PutPromotion"
+                  }
                 }
               }
             }
           },
           "400": {
-            "description": "Thrown when the ID in the request does not match the ID in the document.",
+            "description": "Returned when the ID in the request does not match the ID in the document.",
             "content": {
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "IdConflict400": {
+                    "$ref": "#/components/examples/IdConflict400"
+                  }
                 }
               }
             }
@@ -218,11 +275,13 @@
         ]
       },
       "delete": {
+        "summary": "Delete a promotion for a specified ID.",
         "operationId": "deletePromotion",
         "parameters": [
           {
             "name": "id",
             "in": "path",
+            "description": "The ID of the promotion to create.",
             "required": true,
             "style": "simple",
             "explode": false,
@@ -234,21 +293,29 @@
           {
             "name": "organizationId",
             "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "$ref": "#/components/schemas/OrganizationId"
-            }
+            },
+            "example": "f_ecom_zzxy_prd"
           },
           {
             "name": "siteId",
             "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
             "required": true,
             "style": "form",
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
             }
           }
         ],
@@ -266,11 +333,13 @@
         ]
       },
       "patch": {
+        "summary": "Update a promotion with the specified information.",
         "operationId": "updatePromotion",
         "parameters": [
           {
             "name": "id",
             "in": "path",
+            "description": "The ID of the promotion to create.",
             "required": true,
             "style": "simple",
             "explode": false,
@@ -282,21 +351,29 @@
           {
             "name": "organizationId",
             "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
             "required": true,
             "style": "simple",
             "explode": false,
             "schema": {
               "$ref": "#/components/schemas/OrganizationId"
-            }
+            },
+            "example": "f_ecom_zzxy_prd"
           },
           {
             "name": "siteId",
             "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
             "required": true,
             "style": "form",
             "explode": true,
             "schema": {
               "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
             }
           }
         ],
@@ -305,6 +382,11 @@
             "application/json": {
               "schema": {
                 "$ref": "#/components/schemas/Promotion"
+              },
+              "examples": {
+                "PromotionsPatch": {
+                  "$ref": "#/components/examples/PatchPromotion"
+                }
               }
             }
           }
@@ -316,16 +398,26 @@
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/Promotion"
+                },
+                "examples": {
+                  "PutPromotion": {
+                    "$ref": "#/components/examples/examples-PatchPromotion"
+                  }
                 }
               }
             }
           },
           "404": {
-            "description": "Thrown when there is no promotion found with the given ID for the requested site.",
+            "description": "Returned when there is no promotion found with the given ID for the requested site.",
             "content": {
               "application/json": {
                 "schema": {
                   "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "GetPromotion": {
+                    "$ref": "#/components/examples/PromotionNotFound404"
+                  }
                 }
               }
             }
@@ -339,956 +431,2640 @@
           }
         ]
       }
-    }
-  },
-  "components": {
-    "schemas": {
-      "OrganizationId": {
-        "type": "string",
-        "maxLength": 32,
-        "minLength": 1
-      },
-      "SiteId": {
-        "type": "string",
-        "maxLength": 32,
-        "minLength": 1
-      },
-      "Query": {
-        "type": "object",
-        "additionalProperties": false,
-        "maxProperties": 1,
-        "minProperties": 1,
-        "properties": {
-          "boolQuery": {
-            "$ref": "#/components/schemas/BoolQuery"
-          },
-          "filteredQuery": {
-            "$ref": "#/components/schemas/FilteredQuery"
-          },
-          "matchAllQuery": {
-            "$ref": "#/components/schemas/MatchAllQuery"
-          },
-          "nestedQuery": {
-            "$ref": "#/components/schemas/NestedQuery"
+    },
+    "/organizations/{organizationId}/promotions/{id}/discount-rule": {
+      "get": {
+        "summary": "Retrieve the discount rule for a promotion.",
+        "description": "Returns the discount rule, product qualifiers, and payment-method qualifiers for the promotion.",
+        "operationId": "getPromotionDiscountRule",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "The ID of the promotion to create.",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1
+            }
           },
-          "termQuery": {
-            "$ref": "#/components/schemas/TermQuery"
+          {
+            "name": "organizationId",
+            "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "$ref": "#/components/schemas/OrganizationId"
+            },
+            "example": "f_ecom_zzxy_prd"
           },
-          "textQuery": {
-            "$ref": "#/components/schemas/TextQuery"
-          }
-        }
-      },
-      "BoolQuery": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "must": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Query"
+          {
+            "name": "siteId",
+            "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
+            "required": true,
+            "style": "form",
+            "explode": true,
+            "schema": {
+              "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
             }
-          },
-          "mustNot": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Query"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Retrieved the discount rule successfully.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DiscountRule"
+                },
+                "examples": {
+                  "GetPromotionDiscountRule": {
+                    "$ref": "#/components/examples/GetPromotionDiscountRule"
+                  }
+                }
+              }
             }
           },
-          "should": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Query"
+          "404": {
+            "description": "Returned when there is no promotion found for the specified ID for the requested site.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "getPromotionDiscountRule404": {
+                    "$ref": "#/components/examples/PromotionNotFound404"
+                  }
+                }
+              }
             }
           }
-        }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.promotions",
+              "sfcc.promotions.rw"
+            ]
+          }
+        ]
       },
-      "Filter": {
-        "type": "object",
-        "additionalProperties": false,
-        "maxProperties": 1,
-        "minProperties": 1,
-        "properties": {
-          "boolFilter": {
-            "$ref": "#/components/schemas/BoolFilter"
-          },
-          "queryFilter": {
-            "$ref": "#/components/schemas/QueryFilter"
-          },
-          "range2Filter": {
-            "$ref": "#/components/schemas/Range2Filter"
+      "put": {
+        "summary": "Create or replace the discount rule for a promotion.",
+        "description": "Replaces the entire discount rule, product qualifiers, and payment-method qualifiers for the promotion.",
+        "operationId": "createPromotionDiscountRule",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "The ID of the promotion to create.",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1
+            }
           },
-          "rangeFilter": {
-            "$ref": "#/components/schemas/RangeFilter"
+          {
+            "name": "organizationId",
+            "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "$ref": "#/components/schemas/OrganizationId"
+            },
+            "example": "f_ecom_zzxy_prd"
           },
-          "termFilter": {
-            "$ref": "#/components/schemas/TermFilter"
+          {
+            "name": "siteId",
+            "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
+            "required": true,
+            "style": "form",
+            "explode": true,
+            "schema": {
+              "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
+            }
           }
-        }
-      },
-      "BoolFilter": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "filters": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Filter"
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DiscountRule"
+              },
+              "examples": {
+                "PutPromotionDiscountRule": {
+                  "$ref": "#/components/examples/PutPromotionDiscountRule"
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Discount rule replaced successfully.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DiscountRule"
+                },
+                "examples": {
+                  "PutPromotionDiscountRule": {
+                    "$ref": "#/components/examples/GetPromotionDiscountRule"
+                  }
+                }
+              }
             }
           },
-          "operator": {
-            "type": "string",
-            "enum": [
-              "and",
-              "or",
-              "not"
-            ]
+          "201": {
+            "description": "Discount rule created successfully.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DiscountRule"
+                },
+                "examples": {
+                  "PutPromotionDiscountRule": {
+                    "$ref": "#/components/examples/GetPromotionDiscountRule"
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Returned when there is no promotion found for the specified ID for the requested site.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "putPromotionDiscountRule404": {
+                    "$ref": "#/components/examples/PromotionNotFound404"
+                  }
+                }
+              }
+            }
           }
         },
-        "required": [
-          "operator"
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.promotions.rw"
+            ]
+          }
+        ]
+      },
+      "delete": {
+        "summary": "Delete the discount rule for a promotion.",
+        "description": "Removes the discount rule and its qualifiers from the promotion, resetting it to a shell with no discount configuration.",
+        "operationId": "deletePromotionDiscountRule",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "The ID of the promotion to create.",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          {
+            "name": "organizationId",
+            "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "$ref": "#/components/schemas/OrganizationId"
+            },
+            "example": "f_ecom_zzxy_prd"
+          },
+          {
+            "name": "siteId",
+            "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
+            "required": true,
+            "style": "form",
+            "explode": true,
+            "schema": {
+              "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Deleted the discount rule successfully."
+          },
+          "404": {
+            "description": "Returned when there is no promotion found for the specified ID for the requested site.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "deletePromotionDiscountRule404": {
+                    "$ref": "#/components/examples/PromotionNotFound404"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.promotions.rw"
+            ]
+          }
+        ]
+      },
+      "patch": {
+        "summary": "Update the discount rule for a promotion.",
+        "description": "Updates the discount rule, product qualifiers, or payment-method qualifiers for the promotion. The merge is at\n top-level-section granularity: any of promotionRule, qualifyingProducts, discountedProducts, excludedProducts, or\n paymentMethodQualifiers that is omitted is left unchanged, and any that is supplied fully replaces that section.\n In particular a supplied promotionRule replaces the entire rule - send the complete rule (including all tiers) to\n preserve tiers, since a promotionRule that omits tiers clears them. It is not a field-level (deep) merge.",
+        "operationId": "updatePromotionDiscountRule",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "The ID of the promotion to create.",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          {
+            "name": "organizationId",
+            "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "$ref": "#/components/schemas/OrganizationId"
+            },
+            "example": "f_ecom_zzxy_prd"
+          },
+          {
+            "name": "siteId",
+            "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
+            "required": true,
+            "style": "form",
+            "explode": true,
+            "schema": {
+              "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/DiscountRule"
+              },
+              "examples": {
+                "PatchPromotionDiscountRule": {
+                  "$ref": "#/components/examples/PatchPromotionDiscountRule"
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Discount rule updated successfully.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DiscountRule"
+                },
+                "examples": {
+                  "PatchPromotionDiscountRule": {
+                    "$ref": "#/components/examples/GetPromotionDiscountRule"
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Returned when there is no promotion found for the specified ID for the requested site.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "patchPromotionDiscountRule404": {
+                    "$ref": "#/components/examples/PromotionNotFound404"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.promotions.rw"
+            ]
+          }
+        ]
+      }
+    },
+    "/organizations/{organizationId}/promotions/{id}/compatibility": {
+      "get": {
+        "summary": "Retrieve the compatibility settings for a promotion.",
+        "description": "Returns the stacking / exclusivity settings that control how this promotion combines with other promotions.",
+        "operationId": "getPromotionCompatibility",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "The ID of the promotion to create.",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          {
+            "name": "organizationId",
+            "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "$ref": "#/components/schemas/OrganizationId"
+            },
+            "example": "f_ecom_zzxy_prd"
+          },
+          {
+            "name": "siteId",
+            "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
+            "required": true,
+            "style": "form",
+            "explode": true,
+            "schema": {
+              "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "Retrieved the compatibility settings successfully.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionCompatibility"
+                },
+                "examples": {
+                  "GetPromotionCompatibility": {
+                    "$ref": "#/components/examples/GetPromotionCompatibility"
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Returned when there is no promotion found for the specified ID for the requested site.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "getPromotionCompatibility404": {
+                    "$ref": "#/components/examples/PromotionNotFound404"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.promotions",
+              "sfcc.promotions.rw"
+            ]
+          }
+        ]
+      },
+      "put": {
+        "summary": "Create or replace the compatibility settings for a promotion.",
+        "description": "Replaces the stacking / exclusivity settings for the promotion.",
+        "operationId": "createPromotionCompatibility",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "The ID of the promotion to create.",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          {
+            "name": "organizationId",
+            "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "$ref": "#/components/schemas/OrganizationId"
+            },
+            "example": "f_ecom_zzxy_prd"
+          },
+          {
+            "name": "siteId",
+            "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
+            "required": true,
+            "style": "form",
+            "explode": true,
+            "schema": {
+              "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PromotionCompatibility"
+              },
+              "examples": {
+                "PutPromotionCompatibility": {
+                  "$ref": "#/components/examples/PutPromotionCompatibility"
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Compatibility settings replaced successfully.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionCompatibility"
+                },
+                "examples": {
+                  "PutPromotionCompatibility": {
+                    "$ref": "#/components/examples/GetPromotionCompatibility"
+                  }
+                }
+              }
+            }
+          },
+          "201": {
+            "description": "Compatibility settings created successfully.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionCompatibility"
+                },
+                "examples": {
+                  "PutPromotionCompatibility": {
+                    "$ref": "#/components/examples/GetPromotionCompatibility"
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Returned when there is no promotion found for the specified ID for the requested site.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "putPromotionCompatibility404": {
+                    "$ref": "#/components/examples/PromotionNotFound404"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.promotions.rw"
+            ]
+          }
+        ]
+      },
+      "patch": {
+        "summary": "Update the compatibility settings for a promotion.",
+        "description": "Partially updates the stacking / exclusivity settings for the promotion. Each field (exclusivity, exclusivityGroup,\n combinablePromotions, mutuallyExclusivePromotions) that is omitted is left unchanged. A supplied\n combinablePromotions or mutuallyExclusivePromotions replaces that list wholesale - the entries are not merged into\n the existing list, so send the complete list.",
+        "operationId": "updatePromotionCompatibility",
+        "parameters": [
+          {
+            "name": "id",
+            "in": "path",
+            "description": "The ID of the promotion to create.",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "type": "string",
+              "minLength": 1
+            }
+          },
+          {
+            "name": "organizationId",
+            "in": "path",
+            "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
+            "required": true,
+            "style": "simple",
+            "explode": false,
+            "schema": {
+              "$ref": "#/components/schemas/OrganizationId"
+            },
+            "example": "f_ecom_zzxy_prd"
+          },
+          {
+            "name": "siteId",
+            "in": "query",
+            "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
+            "required": true,
+            "style": "form",
+            "explode": true,
+            "schema": {
+              "$ref": "#/components/schemas/SiteId"
+            },
+            "examples": {
+              "SiteId": {
+                "value": "RefArch"
+              }
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PromotionCompatibility"
+              },
+              "examples": {
+                "PatchPromotionCompatibility": {
+                  "$ref": "#/components/examples/PatchPromotionCompatibility"
+                }
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "Compatibility settings updated successfully.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PromotionCompatibility"
+                },
+                "examples": {
+                  "PatchPromotionCompatibility": {
+                    "$ref": "#/components/examples/GetPromotionCompatibility"
+                  }
+                }
+              }
+            }
+          },
+          "404": {
+            "description": "Returned when there is no promotion found for the specified ID for the requested site.",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                },
+                "examples": {
+                  "patchPromotionCompatibility404": {
+                    "$ref": "#/components/examples/PromotionNotFound404"
+                  }
+                }
+              }
+            }
+          }
+        },
+        "security": [
+          {
+            "AmOAuth2": [
+              "sfcc.promotions.rw"
+            ]
+          }
+        ]
+      }
+    }
+  },
+  "components": {
+    "schemas": {
+      "OrganizationId": {
+        "type": "string",
+        "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
+        "example": "f_ecom_zzxy_prd",
+        "pattern": "^f_ecom_[a-z]{4}_(prd|stg|dev|s[0-9]{2}|[0-9]{3})$"
+      },
+      "SiteId": {
+        "type": "string",
+        "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites",
+        "example": "RefArch",
+        "maxLength": 32,
+        "minLength": 1
+      },
+      "Query": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "A set of objects that define criteria used to select records. A query can contain one of the following:\n* `MatchAllQuery`\n - Matches all documents.\n* `TermQuery`\n - Matches one or more documents against one or more document fields.\n* `TextQuery`\n - Matches text against one or more fields.\n* `BoolQuery`\n - Allows construction of a logical expression of multiple queries.\n* `FilteredQuery`\n - Allows a filter to be applied to a query.\n* `NestedQuery`\n - Allows you to query on nested documents.\n - _Only supported by some Commerce APIs. For more details, see the endpoint descriptions in the API documentation._",
+        "example": {
+          "filteredQuery": {
+            "query": {
+              "textQuery": {
+                "fields": [
+                  "couponId"
+                ],
+                "searchPhrase": "disabled"
+              }
+            },
+            "filter": {
+              "termFilter": {
+                "field": "enabled",
+                "operator": "is",
+                "values": [
+                  false
+                ]
+              }
+            }
+          }
+        },
+        "maxProperties": 1,
+        "minProperties": 1,
+        "properties": {
+          "boolQuery": {
+            "$ref": "#/components/schemas/BoolQuery"
+          },
+          "filteredQuery": {
+            "$ref": "#/components/schemas/FilteredQuery"
+          },
+          "matchAllQuery": {
+            "$ref": "#/components/schemas/MatchAllQuery"
+          },
+          "nestedQuery": {
+            "$ref": "#/components/schemas/NestedQuery"
+          },
+          "termQuery": {
+            "$ref": "#/components/schemas/TermQuery"
+          },
+          "textQuery": {
+            "$ref": "#/components/schemas/TextQuery"
+          }
+        }
+      },
+      "BoolQuery": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "A boolean query allows construction of full logical expression trees that are composed of other queries (usually term queries and text queries). A boolean query has three sets of clauses:\n  \n  - `must`, which combines as an `AND` operator.\n  - `should`, which combines as an `OR` operator.\n  - `must_not`, which combines as a `NOT` operator.\n  \nIf `must`, `mustNot`, or `should` appear in the same boolean query, they are combined logically using the `AND` operator. For example:\n\n    (must-1 AND must-1 AND ...)\n      AND (should-1 OR should-2 OR ...)\n      AND NOT (must_not-1 OR must_not-2 OR ...)\n",
+        "example": {
+          "must": [
+            {
+              "textQuery": {
+                "fields": [
+                  "couponId"
+                ],
+                "searchPhrase": "DEAL"
+              }
+            },
+            {
+              "textQuery": {
+                "fields": [
+                  "description"
+                ],
+                "searchPhrase": "Big bargain deal"
+              }
+            }
+          ],
+          "mustNot": [
+            {
+              "termQuery": {
+                "fields": [
+                  "enabled"
+                ],
+                "operator": "is",
+                "values": [
+                  false
+                ]
+              }
+            }
+          ]
+        },
+        "properties": {
+          "must": {
+            "type": "array",
+            "description": "List of queries to be evaluated as an `AND` operator.",
+            "items": {
+              "$ref": "#/components/schemas/Query"
+            }
+          },
+          "mustNot": {
+            "type": "array",
+            "description": "List of queries to be evaluated as a `NOT` operator.",
+            "items": {
+              "$ref": "#/components/schemas/Query"
+            }
+          },
+          "should": {
+            "type": "array",
+            "description": "List of queries to be evaluated as an `OR` operator.",
+            "items": {
+              "$ref": "#/components/schemas/Query"
+            }
+          }
+        }
+      },
+      "Filter": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Contains a set of objects that define criteria used to select records. A filter can contain one of the following:\n  * `TermFilter`\n   - Matches records where a field (or fields) exactly matches some simple value (including `null`).\n  * `RangeFilter`\n   - Matches records where a field value lies within a specified range.\n  * `Range2Filter`\n   - Matches records in a specified range across fields.\n  * `QueryFilter`\n   - Matches records based on a query.\n  * `BoolFilter`\n   - Provides filtering of records using a set of filters combined using a logical operator.",
+        "maxProperties": 1,
+        "minProperties": 1,
+        "properties": {
+          "boolFilter": {
+            "$ref": "#/components/schemas/BoolFilter"
+          },
+          "queryFilter": {
+            "$ref": "#/components/schemas/QueryFilter"
+          },
+          "range2Filter": {
+            "$ref": "#/components/schemas/Range2Filter"
+          },
+          "rangeFilter": {
+            "$ref": "#/components/schemas/RangeFilter"
+          },
+          "termFilter": {
+            "$ref": "#/components/schemas/TermFilter"
+          }
+        }
+      },
+      "BoolFilter": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Allows you to combine other filters into (possibly recursive) logical expression trees. A boolean filter is composed of a logical operator (`AND`, `OR`, `NOT`) and a list of filters that the operator relates to. Multiple filters can be negated with a single `NOT` operator, even when the filters are combined with the `AND` operator.",
+        "example": {
+          "operator": "and",
+          "filters": [
+            {
+              "termFilter": {
+                "field": "id",
+                "operator": "is",
+                "values": [
+                  "myId"
+                ]
+              }
+            },
+            {
+              "termFilter": {
+                "field": "couponId",
+                "operator": "is",
+                "values": [
+                  "couponOne"
+                ]
+              }
+            }
+          ]
+        },
+        "properties": {
+          "filters": {
+            "type": "array",
+            "description": "A list of filters that are logically combined by an operator.",
+            "items": {
+              "$ref": "#/components/schemas/Filter"
+            }
+          },
+          "operator": {
+            "type": "string",
+            "description": "The logical operator that is used to combine the filters.",
+            "enum": [
+              "and",
+              "or",
+              "not"
+            ],
+            "example": "and"
+          }
+        },
+        "required": [
+          "operator"
         ]
       },
       "QueryFilter": {
         "type": "object",
+        "description": "Wraps any query and allows it to be used as a filter.",
+        "properties": {
+          "query": {
+            "$ref": "#/components/schemas/Query"
+          }
+        },
+        "required": [
+          "query"
+        ]
+      },
+      "Field": {
+        "type": "string",
+        "description": "Name of the field. Might be a custom field name prefixed with c_.",
+        "example": "couponId",
+        "maxLength": 260
+      },
+      "Range2Filter": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Allows you to restrict a search result to hits where a range defined by specified attributes has a certain relationship to a specified range.\n\nThe first range (R1) is defined by a pair of attributes (`fromField` and `toField`) that specify the extent of a range, such as attributes `validFrom` and `validTo`.\n\nThe second range (R2) is defined by `fromValue` and `toValue`.\n\nThe filter mode specifies the method used to compare the two ranges:\n\n* `overlap`: R1 overlaps fully or partially with R2.\n* `containing`: R1 contains R2.\n* `contained`: R1 is contained in R2.\n\nThe range filter supports several value types, and relies on the natural sorting of the value type for range interpretation. Value ranges can be open-ended, but only at one end of the range. You can configure whether the lower bounds and upper bounds are inclusive or exclusive.\n\nA range 2 filter is useful for general restrictions that can be shared between searches (like a static date range) because the filter result is cached in memory. Range filters are not appropriate if the range is expected to be different for every query (for example, if the user controls the date range down to the hour via a UI control). Range filters are inclusive by default.",
+        "example": {
+          "fromField": "validFrom",
+          "toField": "validTo",
+          "filterMode": "overlap",
+          "fromValue": "2007-01-01T00:00:00.000Z",
+          "toValue": "2017-01-01T00:00:00.000Z"
+        },
+        "properties": {
+          "filterMode": {
+            "type": "string",
+            "default": "overlap",
+            "description": "Compare mode: overlap, containing, or contained.",
+            "enum": [
+              "overlap",
+              "containing",
+              "contained"
+            ],
+            "example": "overlap"
+          },
+          "fromField": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Field"
+              }
+            ],
+            "description": "The field name of the field that starts the first range.",
+            "example": "validFrom"
+          },
+          "fromInclusive": {
+            "type": "boolean",
+            "default": true,
+            "description": "A flag indicating if the lower bound of the second range is inclusive. To make the lower bound exclusive, set to `false`.",
+            "example": true
+          },
+          "fromValue": {
+            "description": "The lower bound of the second range. If not specified, the range is open-ended with respect to the lower bound. You can't leave both the lower and upper bounds open-ended.",
+            "example": "2007-01-01T00:00:00.000Z"
+          },
+          "toField": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Field"
+              }
+            ],
+            "description": "The field name of the field that ends the first range.",
+            "example": "validTo"
+          },
+          "toInclusive": {
+            "type": "boolean",
+            "default": true,
+            "description": "A flag indicating if the upper bound of the second range is inclusive. To make the lower bound exclusive, set to `false`.",
+            "example": true
+          },
+          "toValue": {
+            "description": "The upper bound of the second range. If not specified, the range is open-ended with respect to the upper bound. You can't leave both the upper and lower bounds open-ended.",
+            "example": "2017-01-01T00:00:00.000Z"
+          }
+        },
+        "required": [
+          "fromField",
+          "toField"
+        ]
+      },
+      "RangeFilter": {
+        "type": "object",
+        "description": "Allows you to restrict a search result to hits that have values for a given attribute that fall within a given value range. The range filter supports several value types and relies on the natural sorting of the value type for range interpretation. Value ranges can be open-ended, but only at one end of the range. You can configure whether the lower bounds and upper bounds are inclusive or exclusive.\n\nA range filter is useful for general restrictions that can be shared between searches (like a static date range) because the filter result is cached in memory. Range filters are not appropriate if the range is expected to be different for every query (for example, if the user controls the date range down to the hour via a UI control). Range filters are inclusive by default.",
+        "properties": {
+          "field": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Field"
+              }
+            ],
+            "description": "The search field.",
+            "example": "validFrom"
+          },
+          "from": {
+            "description": "The lower bound of the filter range. If not specified, the range is open-ended with respect to the lower bound. You can't leave both the lower and upper bounds open-ended.",
+            "oneOf": [
+              {
+                "type": "string",
+                "format": "date-time",
+                "example": "2007-01-01T00:00:00Z"
+              },
+              {
+                "type": "integer",
+                "example": 1
+              },
+              {
+                "type": "number",
+                "example": 1
+              }
+            ]
+          },
+          "fromInclusive": {
+            "type": "boolean",
+            "default": true,
+            "description": "A flag indicating if the lower bound of the range is inclusive. To make the lower bound exclusive, set to `false`.",
+            "example": true
+          },
+          "to": {
+            "description": "The upper bound of the filter range. If not specified, the range is open-ended with respect to the upper bound. You can't leave both the upper and lower bounds open-ended.",
+            "oneOf": [
+              {
+                "type": "string",
+                "format": "date-time",
+                "example": "2007-01-02T00:00:00Z"
+              },
+              {
+                "type": "integer",
+                "example": 2
+              },
+              {
+                "type": "number",
+                "example": 2
+              }
+            ]
+          },
+          "toInclusive": {
+            "type": "boolean",
+            "default": true,
+            "description": "A flag indicating if the upper bound of the range is inclusive. To make the upper bound exclusive, set to `false`.",
+            "example": true
+          }
+        },
+        "required": [
+          "field"
+        ]
+      },
+      "TermFilter": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Allows you to restrict a search result to hits that match exactly one of the values configured for the filter. A term filter is useful for general restrictions that can be shared between searches. Use term filters whenever the criteria you filter on is a shared property of multiple searches (for example, like filtering by an order status). Use term filters for fields that have a discrete and small set of values only.",
+        "example": {
+          "field": "id",
+          "operator": "is",
+          "values": [
+            "myId"
+          ]
+        },
+        "properties": {
+          "field": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Field"
+              }
+            ],
+            "description": "The filter field."
+          },
+          "operator": {
+            "type": "string",
+            "description": "The operator used to compare the field's values with the given values.",
+            "enum": [
+              "is",
+              "one_of",
+              "is_null",
+              "is_not_null",
+              "less",
+              "greater",
+              "not_in",
+              "neq"
+            ],
+            "example": "is"
+          },
+          "values": {
+            "type": "array",
+            "description": "The filter values.",
+            "items": {
+              "type": "string",
+              "example": "myId"
+            }
+          }
+        },
+        "required": [
+          "field",
+          "operator"
+        ]
+      },
+      "FilteredQuery": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Allows to filter the result of a possibly complex query using a possibly complex filter.",
+        "example": {
+          "query": {
+            "textQuery": {
+              "fields": [
+                "couponId"
+              ],
+              "searchPhrase": "disabled"
+            }
+          },
+          "filter": {
+            "termFilter": {
+              "field": "enabled",
+              "operator": "is",
+              "values": [
+                false
+              ]
+            }
+          }
+        },
+        "properties": {
+          "filter": {
+            "$ref": "#/components/schemas/Filter"
+          },
+          "query": {
+            "$ref": "#/components/schemas/Query"
+          }
+        },
+        "required": [
+          "filter",
+          "query"
+        ]
+      },
+      "MatchAllQuery": {
+        "type": "object",
+        "description": "Matches all documents (namespace and document type). This query comes in handy if you just want to filter a search result or really do not have any constraints."
+      },
+      "NestedQuery": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Allows you to query nested documents that are part of a larger document. Say, for example, that you have a main product with variations in one big document, and you want to constrain a search to main products that have variations that match multiple constraints. \n\nA `NestedQuery` is only supported by some Commerce APIs. For more details, see the endpoint descriptions in the API documentation.\n",
+        "example": {
+          "path": "order.shippingAddresses",
+          "query": {
+            "boolQuery": {
+              "must": [
+                {
+                  "boolQuery": {
+                    "must": [
+                      {
+                        "termQuery": {
+                          "fields": [
+                            "order.shippingAddresses.firstName"
+                          ],
+                          "operator": "is",
+                          "values": [
+                            "John"
+                          ]
+                        }
+                      }
+                    ]
+                  }
+                },
+                {
+                  "boolQuery": {
+                    "must": [
+                      {
+                        "termQuery": {
+                          "fields": [
+                            "order.shippingAddresses.lastName"
+                          ],
+                          "operator": "is",
+                          "values": [
+                            "Doe"
+                          ]
+                        }
+                      }
+                    ]
+                  }
+                }
+              ]
+            }
+          },
+          "scoreMode": "avg"
+        },
         "properties": {
+          "path": {
+            "type": "string",
+            "description": "The path to the nested document.",
+            "example": "order.shippingAddresses",
+            "maxLength": 2048
+          },
           "query": {
             "$ref": "#/components/schemas/Query"
+          },
+          "scoreMode": {
+            "type": "string",
+            "description": "Indicates how scores for matching child objects affect the root parent document’s relevance score.",
+            "enum": [
+              "avg",
+              "total",
+              "max",
+              "none"
+            ],
+            "example": "avg"
           }
         },
         "required": [
+          "path",
           "query"
         ]
       },
-      "Field": {
-        "type": "string",
-        "maxLength": 260
+      "TermQuery": {
+        "type": "object",
+        "description": "A term query matches one or more values against one or more document fields. A document is considered a hit if one of the values matches exactly with at least one of the given fields. The operator `is` can only take one value, while `one_of` can take multiple values. If multiple fields are specified, they are combined using a logical `OR` operator.\n\n**Limitations:**\n\n* The `greater` and `less` operators are not supported under certain conditions. Both operators are permitted unless the API documentation states otherwise.\n* A subset of Commerce APIs handle queries with multiple fields differently. If the query has multiple fields, the query is internally handled as a logical `OR` of `DisjointMaxQueries` (with the dismax matching a value against all fields). The dismax makes sure that a document carrying a single term in multiple fields does not get higher scores than a document matching multiple terms in multiple fields.",
+        "properties": {
+          "fields": {
+            "type": "array",
+            "description": "The document fields that the values are matched against, combined with the operator.",
+            "items": {
+              "$ref": "#/components/schemas/Field"
+            },
+            "minItems": 1
+          },
+          "operator": {
+            "type": "string",
+            "description": "Returns the operator to use for the term query.",
+            "enum": [
+              "is",
+              "one_of",
+              "is_null",
+              "is_not_null",
+              "less",
+              "greater",
+              "not_in",
+              "neq"
+            ],
+            "example": "is"
+          },
+          "values": {
+            "type": "array",
+            "description": "The values that the fields are compared against, combined with the operator.",
+            "items": {
+              "example": "myCouponId",
+              "oneOf": [
+                {
+                  "type": "string",
+                  "example": "myCouponId"
+                },
+                {
+                  "type": "number",
+                  "example": 1
+                },
+                {
+                  "type": "boolean",
+                  "example": true
+                },
+                {
+                  "type": "integer",
+                  "example": 1
+                }
+              ]
+            }
+          }
+        },
+        "required": [
+          "fields",
+          "operator"
+        ]
+      },
+      "TextQuery": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "A text query is used to match some text (for example, a search phrase possibly consisting of multiple terms) against one or more fields. When multiple fields are provided, the phrase conceptually forms a logical `OR` over the fields. In this case, the terms of the phrase basically have to match within the text, that would result in concatenating all given fields.",
+        "example": {
+          "fields": [
+            "couponId"
+          ],
+          "searchPhrase": "limit"
+        },
+        "properties": {
+          "fields": {
+            "type": "array",
+            "description": "The document fields that the search phrase matches against.",
+            "items": {
+              "$ref": "#/components/schemas/Field"
+            },
+            "minItems": 1
+          },
+          "searchPhrase": {
+            "type": "string",
+            "description": "A search phrase, which can include multiple terms separated by spaces.",
+            "example": "campaign summer"
+          }
+        },
+        "required": [
+          "fields",
+          "searchPhrase"
+        ]
+      },
+      "Sort": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Document representing a sort request. Each API has a different default sort configuration that can be modified in the request.",
+        "example": {
+          "field": "couponId",
+          "sortOrder": "desc"
+        },
+        "properties": {
+          "field": {
+            "type": "string",
+            "description": "The name of the field to sort on.",
+            "example": "couponId",
+            "maxLength": 256
+          },
+          "sortOrder": {
+            "type": "string",
+            "default": "asc",
+            "description": "The sort order to be applied when sorting. When omitted, the default sort order (asc) is used.",
+            "enum": [
+              "asc",
+              "desc"
+            ],
+            "example": "asc"
+          }
+        },
+        "required": [
+          "field"
+        ]
+      },
+      "Offset": {
+        "type": "integer",
+        "format": "int32",
+        "default": 0,
+        "description": "The zero-based index of the first hit/data to include in the result.",
+        "example": 0,
+        "minimum": 0
+      },
+      "SearchRequest": {
+        "type": "object",
+        "description": "Document representing a search request for retrieving items within the Data API. The query is a potentially complex set of expressions. The fields and expands that each query supports are defined within the search resource.",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "format": "int32",
+            "description": "Maximum records to retrieve per request, not to exceed 200.",
+            "example": 10,
+            "maximum": 200,
+            "minimum": 1
+          },
+          "query": {
+            "$ref": "#/components/schemas/Query"
+          },
+          "sorts": {
+            "type": "array",
+            "description": "The list of sort clauses configured for the search request. Sort clauses are optional. See the description of the search endpoint for details on the default sorting behavior that is used when explicit sorts are not passed.",
+            "items": {
+              "$ref": "#/components/schemas/Sort"
+            }
+          },
+          "offset": {
+            "$ref": "#/components/schemas/Offset"
+          }
+        },
+        "required": [
+          "query"
+        ]
+      },
+      "Total": {
+        "type": "integer",
+        "format": "int32",
+        "default": 0,
+        "description": "The total number of hits that match the search's criteria. This can be greater than the number of results returned as search results are pagenated.",
+        "example": 10,
+        "minimum": 0
+      },
+      "ResultBase": {
+        "type": "object",
+        "description": "Schema defining generic list result. Each response schema of a resource requiring a list response should extend this schema. \nAdditionally it needs to be defined what data is returned.",
+        "properties": {
+          "limit": {
+            "type": "integer",
+            "format": "int32",
+            "description": "Maximum records to retrieve per request. The limit with its constraints (minimum, maximum, default) is defined by the request parameter `limit` of the endpoint returning this schema.",
+            "example": 10
+          },
+          "total": {
+            "$ref": "#/components/schemas/Total"
+          }
+        },
+        "required": [
+          "limit",
+          "total"
+        ]
+      },
+      "PaginatedResultBase": {
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/ResultBase"
+          }
+        ],
+        "description": "Schema defining generic pageable result. Each response schema of a resource requiring pagination should extend this schema. \nIf you use this extend this schema directly, it needs to be defined what data is returned. Allowed names for the data field is `data`.",
+        "properties": {
+          "offset": {
+            "$ref": "#/components/schemas/Offset"
+          }
+        },
+        "required": [
+          "limit",
+          "offset",
+          "total"
+        ]
+      },
+      "PaginatedSearchResult": {
+        "additionalProperties": false,
+        "allOf": [
+          {
+            "$ref": "#/components/schemas/PaginatedResultBase"
+          }
+        ],
+        "description": "Document representing a generic search result. Each search resource should extend this to define what is returned in the `hits`.",
+        "example": {
+          "limit": 1,
+          "hits": [
+            {
+              "couponId": "coupon1",
+              "creationDate": "2019-10-20T12:00:00Z",
+              "description": "This coupon is used to give 10% off stuff.",
+              "enabled": false,
+              "exportedCodeCount": 0,
+              "lastModified": "2019-10-30T04:23:59Z",
+              "redemptionCount": 3,
+              "redemptionLimits": {
+                "limitPerCode": 1,
+                "limitPerCustomer": 1,
+                "limitPerTimeFrame": {
+                  "limit": 2,
+                  "redemptionTimeFrame": 24
+                }
+              },
+              "singleCode": "MyCode",
+              "systemCodesConfig": {
+                "codePrefix": "SG",
+                "numberOfCodes": 500000
+              },
+              "totalCodesCount": 50,
+              "type": "single_code"
+            }
+          ],
+          "query": {
+            "textQuery": {
+              "fields": [
+                "id",
+                "description"
+              ],
+              "searchPhrase": "stuff"
+            }
+          },
+          "sorts": [
+            {
+              "field": "couponId",
+              "sortOrder": "desc"
+            }
+          ],
+          "offset": 2,
+          "total": 8
+        },
+        "properties": {
+          "query": {
+            "$ref": "#/components/schemas/Query"
+          },
+          "sorts": {
+            "type": "array",
+            "description": "The sorting that was applied to the result.",
+            "items": {
+              "$ref": "#/components/schemas/Sort"
+            }
+          },
+          "hits": {
+            "type": "array",
+            "description": "The sorted array of search hits. Can be empty.",
+            "items": {
+              "type": "object"
+            }
+          }
+        },
+        "required": [
+          "query"
+        ]
+      },
+      "TimeOfDay": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Document representing a time schedule within a single day.",
+        "properties": {
+          "timeFrom": {
+            "type": "string",
+            "description": "The time to start from. Time format: HH:mm or HH:mm:ss. Seconds are ignored and set to 0.",
+            "example": "09:00:00",
+            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9](:[0-5][0-9])?$"
+          },
+          "timeTo": {
+            "type": "string",
+            "description": "The time to end on. Time format: HH:mm or HH:mm:ss. Seconds are ignored and set to 0.",
+            "example": "17:00:00",
+            "pattern": "^([01][0-9]|2[0-3]):[0-5][0-9](:[0-5][0-9])?$"
+          }
+        }
+      },
+      "Recurrence": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "Document representing a schedule recurrence.",
+        "properties": {
+          "dayOfWeek": {
+            "type": "array",
+            "description": "The days of week for recurrence.",
+            "items": {
+              "type": "string",
+              "enum": [
+                "monday",
+                "tuesday",
+                "wednesday",
+                "thursday",
+                "friday",
+                "saturday",
+                "sunday"
+              ],
+              "example": "monday"
+            }
+          },
+          "timeOfDay": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/TimeOfDay"
+              }
+            ],
+            "description": "The time of the day for recurrence."
+          }
+        }
       },
-      "Range2Filter": {
+      "Schedule": {
         "type": "object",
         "additionalProperties": false,
+        "description": "Document representing a time schedule. Defines an optional validity window (startDate/endDate) and an optional recurrence. Omitting a bound leaves that side of the window open (unbounded).",
         "properties": {
-          "filterMode": {
+          "startDate": {
             "type": "string",
-            "default": "overlap",
-            "enum": [
-              "overlap",
-              "containing",
-              "contained"
-            ]
+            "format": "date-time",
+            "description": "The date to start validity. ISO8601 date time format: yyyy-MM-dd'T'HH:mm:ssZ.",
+            "example": "2026-01-01T00:00:00Z"
           },
-          "fromField": {
+          "endDate": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The date to end of validity. ISO8601 date time format: yyyy-MM-dd'T'HH:mm:ssZ.",
+            "example": "2026-01-31T23:59:59Z"
+          },
+          "recurrence": {
             "allOf": [
               {
-                "$ref": "#/components/schemas/Field"
+                "$ref": "#/components/schemas/Recurrence"
               }
-            ]
+            ],
+            "description": "The recurrence of the schedule by day of week and time of day. Not all schedules support a recurrence."
+          }
+        }
+      },
+      "PromotionAbtestGroupAssignment": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "abtestDescription": {
+            "type": "string"
           },
-          "fromInclusive": {
+          "abtestId": {
+            "type": "string"
+          },
+          "enabled": {
             "type": "boolean",
-            "default": true
+            "example": true
           },
-          "fromValue": {},
-          "toField": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/Field"
-              }
-            ]
+          "schedule": {
+            "$ref": "#/components/schemas/Schedule"
           },
-          "toInclusive": {
-            "type": "boolean",
-            "default": true
+          "segmentDescription": {
+            "type": "string"
           },
-          "toValue": {}
+          "segmentId": {
+            "type": "string"
+          }
         },
         "required": [
-          "fromField",
-          "toField"
+          "abtestDescription",
+          "abtestId",
+          "enabled",
+          "schedule",
+          "segmentDescription",
+          "segmentId"
         ]
       },
-      "RangeFilter": {
+      "CampaignId": {
+        "type": "string",
+        "description": "The ID of the campaign.",
+        "example": "NewYearCampaign",
+        "maxLength": 256,
+        "minLength": 1
+      },
+      "Campaign": {
         "type": "object",
+        "additionalProperties": {
+          "description": "This type supports additional properties passed along with the defined properties of this API.\nTo indicate that the properties were defined and expected to be handled as additional properties, they are expected to be prefixed with a `c_`.\nThe type will reject any property that does not fit this pattern, only allowing additional properties beginning with the known prefix.",
+          "example": "c_trackingId",
+          "title": "Additional Property Support"
+        },
+        "description": "Document representing a campaign.",
         "properties": {
-          "field": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/Field"
-              }
-            ]
+          "campaignId": {
+            "$ref": "#/components/schemas/CampaignId"
           },
-          "from": {
-            "oneOf": [
-              {
-                "type": "string",
-                "format": "date-time"
-              },
-              {
-                "type": "integer"
-              },
-              {
-                "type": "number"
-              }
-            ]
+          "coupons": {
+            "type": "array",
+            "description": "The array of assigned coupon IDs, not sorted.",
+            "example": [
+              "20%offOrder",
+              "10%offWelcomeNewUser"
+            ],
+            "items": {
+              "type": "string"
+            }
           },
-          "fromInclusive": {
-            "type": "boolean",
-            "default": true
+          "creationDate": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Returns the value of attribute 'creationDate'.",
+            "example": "2019-10-03T19:36:56Z"
           },
-          "to": {
-            "oneOf": [
-              {
-                "type": "string",
-                "format": "date-time"
-              },
-              {
-                "type": "integer"
-              },
-              {
-                "type": "number"
-              }
-            ]
+          "customerGroups": {
+            "type": "array",
+            "description": "The array of assigned customer groups, not sorted.",
+            "example": [
+              "BigShoppers",
+              "NorthAmericanShoppers"
+            ],
+            "items": {
+              "type": "string"
+            }
           },
-          "toInclusive": {
+          "description": {
+            "type": "string",
+            "description": "The description of the campaign.",
+            "maxLength": 4000
+          },
+          "enabled": {
             "type": "boolean",
-            "default": true
+            "description": "The enabled flag for campaign.",
+            "example": true
+          },
+          "endDate": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The date the scenario ends."
+          },
+          "lastModified": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Returns the value of attribute 'lastModified'.",
+            "example": "2019-10-03T19:36:56Z"
+          },
+          "sourceCodeGroups": {
+            "type": "array",
+            "description": "The array of assigned source code groups, not sorted.",
+            "example": [
+              "affiliate-email",
+              "gaming-email"
+            ],
+            "items": {
+              "type": "string"
+            }
+          },
+          "startDate": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The date the scenario begins.",
+            "example": "2019-10-03T19:36:56Z"
           }
         },
         "required": [
-          "field"
+          "campaignId"
         ]
       },
-      "TermFilter": {
+      "Promotion": {
         "type": "object",
-        "additionalProperties": false,
+        "additionalProperties": {
+          "description": "This type supports additional properties passed along with the defined properties of this API.\nTo indicate that the properties were defined and expected to be handled as additional properties, they are expected to be prefixed with a `c_`.\nThe type will reject any property that does not fit this pattern, only allowing additional properties beginning with the known prefix.",
+          "example": "c_trackingId",
+          "title": "Additional Property Support"
+        },
+        "description": "Document representing a promotion. Unless otherwise stated, attributes of this document are not supported when using\nthe Open Commerce API to update multiple promotions at once.",
         "properties": {
-          "field": {
+          "archived": {
+            "type": "boolean",
+            "description": "Determines if this promotion is archived. This attribute is allowed to be updated when using the Open\n Commerce API to update multiple promotions at once.",
+            "example": true
+          },
+          "assignmentInformation": {
             "allOf": [
               {
-                "$ref": "#/components/schemas/Field"
+                "$ref": "#/components/schemas/PromotionAssignmentInformation"
               }
+            ],
+            "description": "Information about the assignments and assignment schedules of this promotion."
+          },
+          "creationDate": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Returns the value of attribute 'creationDate'."
+          },
+          "currencyCode": {
+            "type": "string",
+            "description": "The ISO 4217 mnemonic code of the currency this promotion is restricted to. If not populated, then there is no\n currency restriction on the promotion.",
+            "maxLength": 3
+          },
+          "disableGloballyExcluded": {
+            "type": "boolean",
+            "description": "Determines if this promotion ignores the global product exclusions for promotions.",
+            "example": true
+          },
+          "enabled": {
+            "type": "boolean",
+            "description": "Determines if this promotion is enabled. This attribute is allowed to be updated when using the Open\n Commerce API to update multiple promotions at once.",
+            "example": true
+          },
+          "exclusivity": {
+            "type": "string",
+            "description": "Determines if the promotion can be combined with other promotions of the same promotion class or if it cannot be\n combined with any other promotions. This attribute is allowed to be updated when using the Open Commerce API to\n update multiple promotions at once.",
+            "enum": [
+              "no",
+              "class",
+              "global"
             ]
           },
-          "operator": {
+          "id": {
+            "type": "string",
+            "description": "The ID for the promotion."
+          },
+          "lastModified": {
+            "type": "string",
+            "format": "date-time",
+            "description": "Returns the value of attribute 'lastModified'."
+          },
+          "name": {
+            "type": "object",
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "The user supplied name of this promotion, which can be localized."
+          },
+          "promotionClass": {
             "type": "string",
+            "description": "The class of the promotion. If the promotion class is modified, then the promotion rule and all of its values,\n such as whether or not to disable global product exclusions, are reset.",
             "enum": [
-              "is",
-              "one_of",
-              "is_null",
-              "is_not_null",
-              "less",
-              "greater",
-              "not_in",
-              "neq"
+              "product",
+              "shipping",
+              "order"
             ]
           },
-          "values": {
+          "tags": {
             "type": "array",
+            "description": "Returns the list of tags assigned to this promotion. If used to set the tags on a promotion, the promotion will\n only have the tags passed in the input. Any existing tags are removed.",
             "items": {
-              "type": "string"
+              "$ref": "#/components/schemas/Tag"
             }
           }
-        },
-        "required": [
-          "field",
-          "operator"
-        ]
+        }
       },
-      "FilteredQuery": {
+      "PromotionCampaignAssignment": {
         "type": "object",
         "additionalProperties": false,
+        "description": "Document representing a promotion campaign assignment.",
         "properties": {
-          "filter": {
-            "$ref": "#/components/schemas/Filter"
+          "campaign": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Campaign"
+              }
+            ],
+            "description": "The campaign."
+          },
+          "campaignId": {
+            "type": "string",
+            "description": "The ID of the campaign.",
+            "maxLength": 256,
+            "minLength": 1
+          },
+          "coupons": {
+            "type": "array",
+            "description": "The sorted array of assigned coupon IDs.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "customerGroups": {
+            "type": "array",
+            "description": "The sorted array of assigned customer groups.",
+            "items": {
+              "type": "string"
+            }
+          },
+          "description": {
+            "type": "string",
+            "description": "The description of the promotion campaign assignment.",
+            "maxLength": 4000
+          },
+          "enabled": {
+            "type": "boolean",
+            "description": "True if the assignment resource is enabled.",
+            "example": true
+          },
+          "promotion": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Promotion"
+              }
+            ],
+            "description": "The promotion."
+          },
+          "promotionId": {
+            "type": "string",
+            "description": "The ID of the promotion.",
+            "maxLength": 256,
+            "minLength": 1
+          },
+          "rank": {
+            "type": "integer",
+            "format": "int32",
+            "description": "The rank of promotion campaign assignment."
+          },
+          "schedule": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Schedule"
+              }
+            ],
+            "description": "The schedule of the assignment resource."
           },
-          "query": {
-            "$ref": "#/components/schemas/Query"
+          "sourceCodeGroups": {
+            "type": "array",
+            "description": "The sorted array of assigned source code groups.",
+            "items": {
+              "type": "string"
+            }
           }
         },
         "required": [
-          "filter",
-          "query"
+          "campaignId",
+          "description",
+          "enabled",
+          "promotionId",
+          "schedule"
         ]
       },
-      "MatchAllQuery": {
-        "type": "object"
-      },
-      "NestedQuery": {
+      "PromotionAssignmentInformation": {
         "type": "object",
         "additionalProperties": false,
         "properties": {
-          "path": {
+          "abtestId": {
             "type": "string",
-            "maxLength": 2048
-          },
-          "query": {
-            "$ref": "#/components/schemas/Query"
+            "description": "If there is only one assignment, and that assignment is an A/B test segment, the ID of the A/B test the segment\nbelongs to. Otherwise, empty."
           },
-          "scoreMode": {
+          "abtestSegmentId": {
             "type": "string",
-            "enum": [
-              "avg",
-              "total",
-              "max",
-              "none"
-            ]
-          }
-        },
-        "required": [
-          "path",
-          "query"
-        ]
-      },
-      "TermQuery": {
-        "type": "object",
-        "properties": {
-          "fields": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Field"
-            },
-            "minItems": 1
+            "description": "If there is only one assignment, and that assignment is an A/B test segment, the ID of the A/B test segment.\n Otherwise, empty."
           },
-          "operator": {
-            "type": "string",
-            "enum": [
-              "is",
-              "one_of",
-              "is_null",
-              "is_not_null",
-              "less",
-              "greater",
-              "not_in",
-              "neq"
-            ]
+          "active": {
+            "type": "boolean",
+            "description": "True if the individual assignment or the multiple assignments are currently active.",
+            "example": true
           },
-          "values": {
+          "activeAbtestAssignments": {
             "type": "array",
+            "description": "A list of currently active A/B tests this is assigned to.",
             "items": {
-              "oneOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "number"
-                },
-                {
-                  "type": "boolean"
-                },
-                {
-                  "type": "integer"
-                }
-              ]
+              "$ref": "#/components/schemas/PromotionAbtestGroupAssignment"
             }
-          }
-        },
-        "required": [
-          "fields",
-          "operator"
-        ]
-      },
-      "TextQuery": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "fields": {
+          },
+          "activeCampaignAssignments": {
             "type": "array",
+            "description": "A list of currently active campaigns this is assigned to.",
             "items": {
-              "$ref": "#/components/schemas/Field"
-            },
-            "minItems": 1
+              "$ref": "#/components/schemas/PromotionCampaignAssignment"
+            }
           },
-          "searchPhrase": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "fields",
-          "searchPhrase"
-        ]
-      },
-      "String256": {
-        "type": "string",
-        "maxLength": 256
-      },
-      "Sort": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "field": {
+          "campaignId": {
+            "type": "string",
+            "description": "If there is only one assignment, and that assignment is a campaign, the ID of the campaign. Otherwise, empty."
+          },
+          "enabled": {
+            "type": "boolean",
+            "example": true
+          },
+          "endDate": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The end date of the container of the assignment (a Campaign or ABTest). If scheduleType is\n scheduleType : \"multiple\" or scheduleType : \"none\", then then result is null. Also, a null\n date returns null."
+          },
+          "schedule": {
             "allOf": [
               {
-                "$ref": "#/components/schemas/String256"
+                "$ref": "#/components/schemas/Schedule"
               }
-            ]
+            ],
+            "description": "The schedule of the assignment (a Campaign or ABTest). If scheduleType is\n scheduleType : \"multiple\" or scheduleType : \"none\", then then result is null."
           },
-          "sortOrder": {
+          "scheduleType": {
             "type": "string",
-            "default": "asc",
+            "description": "If there is only one active assignment, or no active assignments and one upcoming assignment, this is that type\n of assignment (scheduleType : \"campaign\" or scheduleType : \"abtest\"). If there are no\n assignments, it is scheduleType : \"none\", otherwise, scheduleType : \"multiple\".",
             "enum": [
-              "asc",
-              "desc"
+              "none",
+              "campaign",
+              "abtest",
+              "multiple"
             ]
-          }
-        },
-        "required": [
-          "field"
-        ]
-      },
-      "Offset": {
-        "type": "integer",
-        "format": "int32",
-        "default": 0,
-        "minimum": 0
-      },
-      "SearchRequest": {
-        "type": "object",
-        "properties": {
-          "limit": {
-            "type": "integer",
-            "format": "int32",
-            "maximum": 200,
-            "minimum": 1
           },
-          "query": {
-            "$ref": "#/components/schemas/Query"
+          "startDate": {
+            "type": "string",
+            "format": "date-time",
+            "description": "The start date of the container of the assignment (a Campaign or ABTest). If scheduleType is\n scheduleType : \"multiple\" or scheduleType : \"none\", then then result is null. Also, a null\n date returns null."
           },
-          "sorts": {
+          "upcomingAbtestAssignments": {
             "type": "array",
+            "description": "A list of upcoming A/B tests this is assigned to.",
             "items": {
-              "$ref": "#/components/schemas/Sort"
+              "$ref": "#/components/schemas/PromotionAbtestGroupAssignment"
             }
           },
-          "offset": {
-            "$ref": "#/components/schemas/Offset"
+          "upcomingCampaignAssignments": {
+            "type": "array",
+            "description": "A list of upcoming campaigns this is assigned to.",
+            "items": {
+              "$ref": "#/components/schemas/PromotionCampaignAssignment"
+            }
           }
         },
         "required": [
-          "query"
+          "active",
+          "activeCampaignAssignments",
+          "campaignId",
+          "enabled",
+          "schedule",
+          "scheduleType"
         ]
       },
-      "Total": {
-        "type": "integer",
-        "format": "int32",
-        "default": 0,
-        "minimum": 0
-      },
-      "ResultBase": {
+      "Tag": {
         "type": "object",
+        "additionalProperties": false,
+        "description": "Document representing a tag",
         "properties": {
-          "limit": {
-            "type": "integer",
-            "format": "int32"
-          },
-          "total": {
-            "$ref": "#/components/schemas/Total"
+          "tagId": {
+            "type": "string",
+            "description": "The ID of the tag."
           }
         },
         "required": [
-          "limit",
-          "total"
+          "tagId"
         ]
       },
-      "PaginatedResultBase": {
+      "PromotionSearchResult": {
         "allOf": [
           {
-            "$ref": "#/components/schemas/ResultBase"
+            "$ref": "#/components/schemas/PaginatedSearchResult"
           }
         ],
+        "description": "Document representing a promotion search result.",
         "properties": {
-          "offset": {
-            "$ref": "#/components/schemas/Offset"
+          "hits": {
+            "type": "array",
+            "description": "The sorted array of promotion search hits. Can be empty.",
+            "items": {
+              "$ref": "#/components/schemas/Promotion"
+            }
           }
         },
         "required": [
-          "limit",
-          "offset",
-          "total"
+          "hits"
         ]
       },
-      "PaginatedSearchResult": {
-        "additionalProperties": false,
-        "allOf": [
-          {
-            "$ref": "#/components/schemas/PaginatedResultBase"
-          }
-        ],
+      "ErrorResponse": {
+        "type": "object",
+        "additionalProperties": true,
         "properties": {
-          "query": {
-            "$ref": "#/components/schemas/Query"
+          "title": {
+            "type": "string",
+            "description": "A short, human-readable summary of the problem\ntype.  It will not change from occurrence to occurrence of the \nproblem, except for purposes of localization\n",
+            "example": "You do not have enough credit",
+            "maxLength": 256
           },
-          "sorts": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Sort"
-            }
+          "type": {
+            "type": "string",
+            "description": "A URI reference [RFC3986] that identifies the\nproblem type.  This specification encourages that, when\ndereferenced, it provide human-readable documentation for the\nproblem type (e.g., using HTML [W3C.REC-html5-20141028]).  When\nthis member is not present, its value is assumed to be\n\"about:blank\". It accepts relative URIs; this means\nthat they must be resolved relative to the document's base URI, as\nper [RFC3986], Section 5.\n",
+            "example": "NotEnoughMoney",
+            "maxLength": 2048
           },
-          "hits": {
-            "type": "array",
-            "items": {
-              "type": "object"
-            }
+          "detail": {
+            "type": "string",
+            "description": "A human-readable explanation specific to this occurrence of the problem.",
+            "example": "Your current balance is 30, but that costs 50"
+          },
+          "instance": {
+            "type": "string",
+            "description": "A URI reference that identifies the specific\noccurrence of the problem.  It may or may not yield further\ninformation if dereferenced.  It accepts relative URIs; this means\nthat they must be resolved relative to the document's base URI, as\nper [RFC3986], Section 5.\n",
+            "example": "/account/12345/msgs/abc",
+            "maxLength": 2048
           }
         },
         "required": [
-          "query"
+          "detail",
+          "title",
+          "type"
         ]
       },
-      "TimeOfDay": {
+      "CurrencyCode": {
+        "type": "string",
+        "description": "A three letter uppercase currency code conforming to the [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html) standard, or the string `N/A` indicating that a currency is not applicable.",
+        "example": "USD",
+        "pattern": "^([A-Z][A-Z][A-Z]|N/A)$"
+      },
+      "Money": {
+        "type": "object",
+        "description": "A combination of a Currency and an amount of that Currency.",
+        "properties": {
+          "currencyMnemonic": {
+            "$ref": "#/components/schemas/CurrencyCode"
+          },
+          "value": {
+            "type": "number",
+            "format": "double",
+            "description": "The amount of money for the given currency.",
+            "example": 1234.56
+          }
+        }
+      },
+      "Percentage": {
+        "type": "number",
+        "format": "double",
+        "description": "A percentage value, from 0 to 100.",
+        "example": 10,
+        "maximum": 100,
+        "minimum": 0
+      },
+      "ProductId": {
+        "type": "string",
+        "description": "The id (SKU) of the product.",
+        "example": "apple-ipod-classic",
+        "maxLength": 100,
+        "minLength": 1
+      },
+      "Discount": {
         "type": "object",
         "additionalProperties": false,
+        "description": "A discount value object. The type determines which value field applies: amount, fixed_price, total_fixed_price,\n and fixed_price_shipping use amount; percentage and percent_off_options use percentage; price_book_price uses\n priceBookId; bonus and bonus_choice use bonusProducts; free_shipping carries no value.\nValid types depend on the enclosing promotion class - the schema does not enforce this, so the backend rejects an\n out-of-class type: product rules accept amount, percentage, fixed_price, total_fixed_price, price_book_price, bonus,\n bonus_choice, free_shipping, fixed_price_shipping, percent_off_options; order rules accept amount, percentage, bonus,\n bonus_choice; shipping rules accept fixed_price, percentage, amount. A BOGO discount is a stricter product subset:\n fixed_price, price_book_price, percentage, amount.",
         "properties": {
-          "timeFrom": {
-            "type": "string"
+          "type": {
+            "type": "string",
+            "description": "The kind of discount.",
+            "enum": [
+              "amount",
+              "percentage",
+              "fixed_price",
+              "total_fixed_price",
+              "price_book_price",
+              "bonus",
+              "bonus_choice",
+              "free_shipping",
+              "fixed_price_shipping",
+              "percent_off_options"
+            ],
+            "example": "amount"
+          },
+          "amount": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Money"
+              }
+            ],
+            "description": "The monetary value, for amount, fixed_price, total_fixed_price, and fixed_price_shipping discounts."
           },
-          "timeTo": {
-            "type": "string"
+          "percentage": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Percentage"
+              }
+            ],
+            "description": "The percentage off, for percentage and percent_off_options discounts."
+          },
+          "priceBookId": {
+            "type": "string",
+            "description": "The price book the discounted price is taken from, for a price_book_price discount.",
+            "example": "usd-list-prices",
+            "maxLength": 256
+          },
+          "bonusProducts": {
+            "type": "array",
+            "description": "The bonus products offered, for bonus and bonus_choice discounts.",
+            "items": {
+              "$ref": "#/components/schemas/ProductId"
+            }
           }
         },
         "required": [
-          "timeFrom",
-          "timeTo"
+          "type"
         ]
       },
-      "Recurrence": {
+      "TieredDiscount": {
         "type": "object",
         "additionalProperties": false,
+        "description": "A single discount tier - a threshold and the discount applied once the threshold is met. \n All tiers in the same rule MUST carry the same conditionType - the backend applies one condition-type to the whole\n tier set and rejects mixed values.",
         "properties": {
-          "dayOfWeek": {
-            "type": "array",
-            "items": {
-              "type": "string",
-              "enum": [
-                "monday",
-                "tuesday",
-                "wednesday",
-                "thursday",
-                "friday",
-                "saturday",
-                "sunday"
-              ]
-            }
-          },
-          "timeOfDay": {
+          "threshold": {
+            "type": "number",
+            "format": "double",
+            "description": "The threshold at which this tier's discount applies.",
+            "example": 100,
+            "minimum": 0
+          },
+          "conditionType": {
+            "type": "string",
+            "description": "The kind of threshold. All tiers in the same rule MUST send the same value. Valid values depend on the promotion class -\n product: product_quantity, product_amount; order: order_total, product_quantity, product_combination;\n shipping: shipment_total, product_quantity, product_combination.",
+            "enum": [
+              "product_quantity",
+              "product_amount",
+              "order_total",
+              "product_combination",
+              "shipment_total"
+            ],
+            "example": "order_total"
+          },
+          "discount": {
             "allOf": [
               {
-                "$ref": "#/components/schemas/TimeOfDay"
+                "$ref": "#/components/schemas/Discount"
               }
-            ]
+            ],
+            "description": "The discount applied at this tier."
           }
         },
         "required": [
-          "dayOfWeek",
-          "timeOfDay"
+          "conditionType",
+          "discount",
+          "threshold"
         ]
       },
-      "Schedule": {
+      "BogoDiscount": {
         "type": "object",
         "additionalProperties": false,
+        "description": "A buy-one-get-one discount. In Business Manager the Type selector (Buy X / Get Y) is Product-class only.",
         "properties": {
-          "endDate": {
-            "type": "string",
-            "format": "date-time"
-          },
-          "recurrence": {
+          "threshold": {
+            "type": "number",
+            "format": "double",
+            "description": "The quantity of eligible products required.",
+            "example": 1,
+            "minimum": 0
+          },
+          "discount": {
             "allOf": [
               {
-                "$ref": "#/components/schemas/Recurrence"
+                "$ref": "#/components/schemas/Discount"
               }
-            ]
+            ],
+            "description": "The discount applied to the bonus product; typically fixed_price, percentage, or amount."
           },
-          "startDate": {
-            "type": "string",
-            "format": "date-time"
+          "eligibleQuantity": {
+            "type": "integer",
+            "format": "int32",
+            "description": "The number of eligible products that earn the bonus.",
+            "example": 1,
+            "minimum": 1
+          },
+          "requireExactEligibleQuantity": {
+            "type": "boolean",
+            "description": "Determines if exactly the eligible quantity is required, rather than at least.",
+            "example": false
           }
         }
       },
-      "PromotionAbtestGroupAssignment": {
+      "ProductPromotionRule": {
         "type": "object",
         "additionalProperties": false,
+        "description": "The discount rule for a product promotion.",
         "properties": {
-          "abtestDescription": {
-            "type": "string"
-          },
-          "abtestId": {
-            "type": "string"
-          },
-          "enabled": {
-            "type": "boolean"
-          },
-          "schedule": {
-            "$ref": "#/components/schemas/Schedule"
-          },
-          "segmentDescription": {
-            "type": "string"
-          },
-          "segmentId": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "abtestDescription",
-          "abtestId",
-          "enabled",
-          "schedule",
-          "segmentDescription",
-          "segmentId"
-        ]
-      },
-      "CampaignId": {
-        "type": "string",
-        "maxLength": 256,
-        "minLength": 1
-      },
-      "Campaign": {
-        "type": "object",
-        "additionalProperties": {},
-        "properties": {
-          "campaignId": {
-            "$ref": "#/components/schemas/CampaignId"
-          },
-          "coupons": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
-          },
-          "creationDate": {
+          "promotionClass": {
             "type": "string",
-            "format": "date-time"
+            "description": "The promotion class discriminator. Always product for a product promotion rule.",
+            "enum": [
+              "product"
+            ],
+            "example": "product"
           },
-          "customerGroups": {
+          "discount": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Discount"
+              }
+            ],
+            "description": "The discount applied by this rule."
+          },
+          "tiers": {
             "type": "array",
+            "description": "The tiered discounts, applied by threshold. Empty or absent for a non-tiered rule.",
             "items": {
-              "type": "string"
+              "$ref": "#/components/schemas/TieredDiscount"
             }
           },
-          "description": {
-            "type": "string",
-            "maxLength": 4000
-          },
-          "enabled": {
-            "type": "boolean"
+          "bogo": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/BogoDiscount"
+              }
+            ],
+            "description": "The buy-one-get-one discount. Present only for a buy-X-get-Y product promotion."
           },
-          "endDate": {
-            "type": "string",
-            "format": "date-time"
+          "maxApplications": {
+            "type": "integer",
+            "format": "int32",
+            "description": "The maximum number of times the discount can be applied.",
+            "example": 1,
+            "minimum": 1
           },
-          "lastModified": {
-            "type": "string",
-            "format": "date-time"
+          "identicalProducts": {
+            "type": "boolean",
+            "description": "Determines if the qualifying and discounted products must all be identical.",
+            "example": false
           },
-          "sourceCodeGroups": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
+          "prorate": {
+            "type": "boolean",
+            "description": "Determines if the discount is prorated across the eligible items.",
+            "example": false
           },
-          "startDate": {
-            "type": "string",
-            "format": "date-time"
+          "disableGlobalExcludedProducts": {
+            "type": "boolean",
+            "default": false,
+            "description": "Determines if this rule ignores the site-level global product exclusions. Distinct from the\n promotion-level disableGloballyExcluded flag.",
+            "example": false
           }
         },
         "required": [
-          "campaignId"
+          "promotionClass"
         ]
       },
-      "Promotion": {
+      "OrderPromotionRule": {
         "type": "object",
-        "additionalProperties": {},
+        "additionalProperties": false,
+        "description": "The discount rule for an order promotion.",
         "properties": {
-          "archived": {
-            "type": "boolean"
-          },
-          "assignmentInformation": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/PromotionAssignmentInformation"
-              }
-            ]
-          },
-          "creationDate": {
-            "type": "string",
-            "format": "date-time"
-          },
-          "currencyCode": {
-            "type": "string",
-            "maxLength": 3
-          },
-          "disableGloballyExcluded": {
-            "type": "boolean"
-          },
-          "enabled": {
-            "type": "boolean"
-          },
-          "exclusivity": {
-            "type": "string",
-            "enum": [
-              "no",
-              "class",
-              "global"
-            ]
-          },
-          "id": {
-            "type": "string"
-          },
-          "lastModified": {
-            "type": "string",
-            "format": "date-time"
-          },
-          "name": {
-            "type": "object",
-            "additionalProperties": {
-              "type": "string"
-            }
-          },
           "promotionClass": {
             "type": "string",
+            "description": "The promotion class discriminator. Always order for an order promotion rule.",
             "enum": [
-              "product",
-              "shipping",
               "order"
-            ]
+            ],
+            "example": "order"
           },
-          "tags": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/Tag"
-            }
-          }
-        }
-      },
-      "PromotionCampaignAssignment": {
-        "type": "object",
-        "additionalProperties": false,
-        "properties": {
-          "campaign": {
+          "discount": {
             "allOf": [
               {
-                "$ref": "#/components/schemas/Campaign"
+                "$ref": "#/components/schemas/Discount"
               }
-            ]
-          },
-          "campaignId": {
-            "type": "string",
-            "maxLength": 256,
-            "minLength": 1
-          },
-          "coupons": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
+            ],
+            "description": "The discount applied by this rule."
           },
-          "customerGroups": {
+          "tiers": {
             "type": "array",
+            "description": "The tiered discounts, applied by threshold. Empty or absent for a non-tiered rule.",
             "items": {
-              "type": "string"
+              "$ref": "#/components/schemas/TieredDiscount"
             }
           },
-          "description": {
-            "type": "string",
-            "maxLength": 4000
-          },
-          "enabled": {
-            "type": "boolean"
+          "discountOnlyQualifyingProducts": {
+            "type": "boolean",
+            "description": "Determines if only the qualifying products are discounted.",
+            "example": false
           },
-          "promotion": {
-            "allOf": [
-              {
-                "$ref": "#/components/schemas/Promotion"
-              }
-            ]
+          "excludeDiscountedProducts": {
+            "type": "boolean",
+            "description": "Determines if products that already received a product-level discount are excluded.",
+            "example": false
           },
-          "promotionId": {
-            "type": "string",
-            "maxLength": 256,
-            "minLength": 1
+          "disableGlobalExcludedProducts": {
+            "type": "boolean",
+            "default": false,
+            "description": "Determines if this rule ignores the site-level global product exclusions. Distinct from the\n promotion-level disableGloballyExcluded flag.",
+            "example": false
           },
-          "rank": {
-            "type": "integer",
-            "format": "int32"
+          "enableUpsells": {
+            "type": "boolean",
+            "description": "Determines if the promotion is returned as an approaching promotion to encourage upsell.",
+            "example": false
           },
-          "schedule": {
+          "upsellThreshold": {
             "allOf": [
               {
-                "$ref": "#/components/schemas/Schedule"
+                "$ref": "#/components/schemas/Money"
               }
-            ]
-          },
-          "sourceCodeGroups": {
-            "type": "array",
-            "items": {
-              "type": "string"
-            }
+            ],
+            "description": "The amount by which the merchandise total may fall short of the purchase condition and still upsell."
           }
         },
         "required": [
-          "campaignId",
-          "description",
-          "enabled",
-          "promotionId",
-          "schedule"
+          "promotionClass"
         ]
       },
-      "PromotionAssignmentInformation": {
+      "PromotedShippingMethods": {
         "type": "object",
         "additionalProperties": false,
+        "description": "The shipping methods a shipping promotion applies to.",
         "properties": {
-          "abtestId": {
-            "type": "string"
-          },
-          "abtestSegmentId": {
-            "type": "string"
-          },
-          "active": {
-            "type": "boolean"
-          },
-          "activeAbtestAssignments": {
+          "methodIds": {
             "type": "array",
+            "description": "The shipping method IDs.",
             "items": {
-              "$ref": "#/components/schemas/PromotionAbtestGroupAssignment"
+              "type": "string",
+              "example": "001",
+              "maxLength": 256
             }
+          }
+        }
+      },
+      "ShippingPromotionRule": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "The discount rule for a shipping promotion.",
+        "properties": {
+          "promotionClass": {
+            "type": "string",
+            "description": "The promotion class discriminator. Always shipping for a shipping promotion rule.",
+            "enum": [
+              "shipping"
+            ],
+            "example": "shipping"
           },
-          "activeCampaignAssignments": {
+          "discount": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/Discount"
+              }
+            ],
+            "description": "The discount applied by this rule."
+          },
+          "tiers": {
             "type": "array",
+            "description": "The tiered discounts, applied by threshold. Empty or absent for a non-tiered rule.",
             "items": {
-              "$ref": "#/components/schemas/PromotionCampaignAssignment"
+              "$ref": "#/components/schemas/TieredDiscount"
             }
           },
-          "campaignId": {
-            "type": "string"
-          },
-          "enabled": {
-            "type": "boolean"
-          },
-          "endDate": {
-            "type": "string",
-            "format": "date-time"
-          },
-          "schedule": {
+          "shippingMethodQualifiers": {
             "allOf": [
               {
-                "$ref": "#/components/schemas/Schedule"
+                "$ref": "#/components/schemas/PromotedShippingMethods"
               }
-            ]
+            ],
+            "description": "The shipping methods the promotion applies to. Shipping-class only."
           },
-          "scheduleType": {
+          "prohibitNonqualifyingProducts": {
+            "type": "boolean",
+            "description": "Determines if the shipment must contain only qualifying products for the discount to apply.",
+            "example": false
+          },
+          "disableGlobalExcludedProducts": {
+            "type": "boolean",
+            "default": false,
+            "description": "Determines if this rule ignores the site-level global product exclusions. Distinct from the\n promotion-level disableGloballyExcluded flag.",
+            "example": false
+          },
+          "maxApplications": {
+            "type": "integer",
+            "format": "int32",
+            "description": "The maximum number of times the discount can be applied.",
+            "example": 1,
+            "minimum": 1
+          }
+        },
+        "required": [
+          "promotionClass"
+        ]
+      },
+      "PromotionRule": {
+        "description": "The discount rule for a promotion. The concrete shape is selected by promotionClass: a product promotion uses\n ProductPromotionRule, an order promotion uses OrderPromotionRule, and a shipping promotion uses ShippingPromotionRule.",
+        "discriminator": {
+          "propertyName": "promotionClass",
+          "mapping": {
+            "product": "#/components/schemas/ProductPromotionRule",
+            "order": "#/components/schemas/OrderPromotionRule",
+            "shipping": "#/components/schemas/ShippingPromotionRule"
+          }
+        },
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/ProductPromotionRule"
+          },
+          {
+            "$ref": "#/components/schemas/OrderPromotionRule"
+          },
+          {
+            "$ref": "#/components/schemas/ShippingPromotionRule"
+          }
+        ]
+      },
+      "ProductCondition": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "A single product condition - a condition type, a comparison operator, and one or more values. Each condition type\n supports a specific operator (for example, category supports is_equal, is_exactly,\n is_child_of; brand and attribute add exists / does_not_exist).",
+        "properties": {
+          "type": {
             "type": "string",
+            "description": "The kind of product condition.",
             "enum": [
-              "none",
-              "campaign",
-              "abtest",
-              "multiple"
-            ]
+              "brand",
+              "product_id",
+              "category",
+              "price",
+              "inventory",
+              "attribute",
+              "product_set",
+              "price_book",
+              "option"
+            ],
+            "example": "category"
           },
-          "startDate": {
+          "operator": {
             "type": "string",
-            "format": "date-time"
+            "description": "The comparison operator, as a lower_snake_case token. The valid set depends on the condition type:\n category: is_equal, is_exactly, is_direct_child_of, is_child_of, is_direct_parent_of, is_parent_of, is_sibling_of;\n brand: exists, does_not_exist, is_equal, is_not_equal, starts_with, ends_with, contains, does_not_contain;\n product_id: is_equal, is_not_equal, starts_with, ends_with, contains, does_not_contain;\n price: less_than, greater_than, ends_with;\n inventory: less_than, greater_than;\n attribute: less_than, greater_than, equals, is_not_equal, exists, does_not_exist, starts_with, ends_with, contains, does_not_contain;\n product_set: is_equal, exists;\n price_book: storefront_price_in_recursive, storefront_price_in, price_in;\n option: is_equal, exists, does_not_exist.",
+            "example": "is_equal",
+            "maxLength": 256
           },
-          "upcomingAbtestAssignments": {
+          "values": {
             "type": "array",
+            "description": "The values compared against.",
             "items": {
-              "$ref": "#/components/schemas/PromotionAbtestGroupAssignment"
+              "type": "string",
+              "example": "electronics",
+              "maxLength": 256
             }
           },
-          "upcomingCampaignAssignments": {
-            "type": "array",
-            "items": {
-              "$ref": "#/components/schemas/PromotionCampaignAssignment"
-            }
+          "catalogId": {
+            "type": "string",
+            "description": "The id of the catalog that owns the categories listed in `values`. Required when `type` is `category; ignored for every other condition type.",
+            "example": "storefront-catalog-m-en",
+            "maxLength": 256
+          },
+          "attributeId": {
+            "type": "string",
+            "description": "The id of the custom product attribute to compare. Required when `type` is `attribute`; ignored for every\n other condition type.",
+            "example": "color",
+            "maxLength": 256
+          },
+          "optionId": {
+            "type": "string",
+            "description": "The id of the product option to compare. Required when `type` is `option`; ignored for every other\n condition type.",
+            "example": "memorySize",
+            "maxLength": 256
           }
         },
         "required": [
-          "active",
-          "activeCampaignAssignments",
-          "campaignId",
-          "enabled",
-          "schedule",
-          "scheduleType"
+          "type"
         ]
       },
-      "Tag": {
+      "ProductConditionGroup": {
         "type": "object",
         "additionalProperties": false,
+        "description": "A group of product conditions.",
         "properties": {
-          "tagId": {
-            "type": "string"
+          "conditions": {
+            "type": "array",
+            "description": "The conditions in this group.",
+            "items": {
+              "$ref": "#/components/schemas/ProductCondition"
+            }
           }
-        },
-        "required": [
-          "tagId"
-        ]
+        }
       },
-      "PromotionSearchResult": {
-        "allOf": [
-          {
-            "$ref": "#/components/schemas/PaginatedSearchResult"
+      "ProductSpecification": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "A set of product conditions. A product matches when it satisfies the included-products groups and none of the\n excluded-products groups.",
+        "properties": {
+          "includedProducts": {
+            "type": "array",
+            "description": "The condition groups a product must match.",
+            "items": {
+              "$ref": "#/components/schemas/ProductConditionGroup"
+            }
+          },
+          "excludedProducts": {
+            "type": "array",
+            "description": "The condition groups that exclude a product.",
+            "items": {
+              "$ref": "#/components/schemas/ProductConditionGroup"
+            }
           }
-        ],
+        }
+      },
+      "PromotedPaymentMethods": {
+        "type": "object",
+        "additionalProperties": false,
+        "description": "The payment methods a promotion is restricted to.",
         "properties": {
-          "hits": {
+          "methodIds": {
             "type": "array",
+            "description": "The payment method IDs. Each is either a payment method ID or a credit card type prefixed with CREDIT_CARD\n (for example CREDIT_CARD.Visa).",
             "items": {
-              "$ref": "#/components/schemas/Promotion"
+              "type": "string",
+              "example": "CREDIT_CARD.Visa",
+              "maxLength": 256
             }
           }
+        }
+      },
+      "DiscountRule": {
+        "type": "object",
+        "additionalProperties": {
+          "description": "This type supports additional properties passed along with the defined properties of this API.\nTo indicate that the properties were defined and expected to be handled as additional properties, they are expected to be prefixed with a `c_`.\nThe type will reject any property that does not fit this pattern, only allowing additional properties beginning with the known prefix.",
+          "example": "c_trackingId",
+          "title": "Additional Property Support"
         },
-        "required": [
-          "hits"
-        ]
+        "description": "The discount-rule document for a promotion, managed as a sub-resource at /promotions/{id}/discount-rule. It holds\n the discount rule (shape selected by promotionClass), the product qualifiers, and the payment-method qualifiers.\n The promotion shell (id, name, enabled, promotionClass) is managed separately on the\n parent /promotions/{id} resource.",
+        "properties": {
+          "promotionRule": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/PromotionRule"
+              }
+            ],
+            "description": "The discount rule for this promotion. Its shape is selected by the parent promotion's promotionClass (product,\n order, or shipping) and holds the discount, tiers, BOGO, thresholds, max-applications, and class-specific flags."
+          },
+          "qualifyingProducts": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ProductSpecification"
+              }
+            ],
+            "description": "The products a customer must purchase for the promotion to apply."
+          },
+          "discountedProducts": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ProductSpecification"
+              }
+            ],
+            "description": "The products that receive the discount. Valid only for a product-class promotion; supplying it for an order or shipping\n promotion is rejected with a 400."
+          },
+          "excludedProducts": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/ProductSpecification"
+              }
+            ],
+            "description": "The products excluded from both qualifying for and receiving the discount. Valid only for an order-class\n promotion; supplying it for a product or shipping promotion is rejected with a 400."
+          },
+          "paymentMethodQualifiers": {
+            "allOf": [
+              {
+                "$ref": "#/components/schemas/PromotedPaymentMethods"
+              }
+            ],
+            "description": "The payment methods the promotion is restricted to."
+          }
+        }
       },
-      "ErrorResponse": {
+      "PromotionCompatibility": {
         "type": "object",
-        "additionalProperties": true,
+        "additionalProperties": {
+          "description": "This type supports additional properties passed along with the defined properties of this API.\nTo indicate that the properties were defined and expected to be handled as additional properties, they are expected to be prefixed with a `c_`.\nThe type will reject any property that does not fit this pattern, only allowing additional properties beginning with the known prefix.",
+          "example": "c_trackingId",
+          "title": "Additional Property Support"
+        },
+        "description": "The compatibility (stacking / exclusivity) document for a promotion, managed as a sub-resource at\n /promotions/{id}/compatibility. It controls how this promotion combines with other promotions of the same class.",
         "properties": {
-          "title": {
+          "exclusivity": {
             "type": "string",
-            "maxLength": 256
+            "description": "Determines if the promotion can be combined with other promotions of the same promotion class, cannot be\n combined with any other promotion, or has no exclusivity restriction.",
+            "enum": [
+              "no",
+              "class",
+              "global"
+            ],
+            "example": "class"
           },
-          "type": {
+          "exclusivityGroup": {
             "type": "string",
-            "maxLength": 2048
+            "description": "The ID of the exclusivity group this promotion belongs to. Only meaningful when exclusivity restricts\n combination to promotions within the same group.",
+            "example": "SummerSale",
+            "maxLength": 256
           },
-          "detail": {
-            "type": "string"
+          "combinablePromotions": {
+            "type": "array",
+            "description": "The set of promotion or promotion-group IDs this promotion can be combined with.",
+            "items": {
+              "type": "string",
+              "example": "10%offOrder",
+              "maxLength": 256
+            }
           },
-          "instance": {
-            "type": "string",
-            "maxLength": 2048
+          "mutuallyExclusivePromotions": {
+            "type": "array",
+            "description": "The set of promotion or promotion-group IDs this promotion cannot be combined with.",
+            "items": {
+              "type": "string",
+              "example": "20%offOrder",
+              "maxLength": 256
+            }
           }
-        },
-        "required": [
-          "detail",
-          "title",
-          "type"
-        ]
+        }
       }
     },
     "parameters": {
       "organizationId": {
         "name": "organizationId",
         "in": "path",
+        "description": "An identifier for the Salesforce Commerce Cloud organization the request is being made by. It consists of a prefix 'f_ecom_' followed by a 4-character [realm identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#realm-id) and a 3-character [instance type identifier](https://developer.salesforce.com/docs/commerce/commerce-api/guide/base-url.html#instance-id).",
         "required": true,
         "style": "simple",
         "explode": false,
         "schema": {
           "$ref": "#/components/schemas/OrganizationId"
-        }
+        },
+        "example": "f_ecom_zzxy_prd"
       },
       "siteId": {
         "name": "siteId",
         "in": "query",
+        "description": "The identifier of the site that a request is being made in the context of. Attributes might have site specific values, and some objects may only be assigned to specific sites.",
         "required": true,
         "style": "form",
         "explode": true,
         "schema": {
           "$ref": "#/components/schemas/SiteId"
+        },
+        "examples": {
+          "SiteId": {
+            "value": "RefArch"
+          }
         }
       },
       "id": {
         "name": "id",
         "in": "path",
+        "description": "The ID of the promotion to create.",
         "required": true,
         "style": "simple",
         "explode": false,
@@ -1298,9 +3074,277 @@
         }
       }
     },
+    "examples": {
+      "GetPromotion": {
+        "value": {
+          "archived": false,
+          "assignmentInformation": {
+            "active": true,
+            "activeCampaignAssignments": [
+              {
+                "campaignId": "coupon-campaign",
+                "coupons": [
+                  "shipping-promotion-coupon"
+                ],
+                "description": "Coupon Shipping Promotion",
+                "enabled": true,
+                "promotionId": "my-shipping-promotion",
+                "schedule": {}
+              }
+            ],
+            "campaignId": "coupon-campaign",
+            "enabled": true,
+            "schedule": {},
+            "scheduleType": "none"
+          },
+          "creationDate": "2020-01-09T16:50:32.000Z",
+          "disableGloballyExcluded": false,
+          "enabled": true,
+          "exclusivity": "no",
+          "id": "my-shipping-promotion",
+          "lastModified": "2020-01-09T16:50:32.000Z",
+          "name": {
+            "default": "Coupon Shipping Promotion"
+          },
+          "promotionClass": "shipping",
+          "c_customString": "Custom Value"
+        }
+      },
+      "PromotionNotFound404": {
+        "value": {
+          "title": "Promotion Not Found",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/promotion-not-found",
+          "detail": "No promotion with ID 'not-existing-promotion' in site 'SiteGenesis' could be found.",
+          "promotionId": "not-existing-promotion",
+          "siteId": "SiteGenesis"
+        }
+      },
+      "PutPromotion": {
+        "value": {
+          "enabled": true,
+          "name": {
+            "default": "__PROMOTION_ID__"
+          },
+          "exclusivity": "class",
+          "promotionClass": "order",
+          "c_customString": "Custom Value"
+        }
+      },
+      "examples-PutPromotion": {
+        "value": {
+          "archived": false,
+          "assignmentInformation": {
+            "active": false,
+            "activeCampaignAssignments": [],
+            "campaignId": "coupon-campaign",
+            "enabled": true,
+            "schedule": {},
+            "scheduleType": "none"
+          },
+          "creationDate": "2020-01-13T20:22:09.189Z",
+          "disableGloballyExcluded": false,
+          "enabled": true,
+          "exclusivity": "class",
+          "id": "my-promotion",
+          "lastModified": "2020-01-13T20:22:09.199Z",
+          "name": {
+            "default": "__PROMOTION_ID__"
+          },
+          "promotionClass": "order",
+          "c_customString": "Custom Value"
+        }
+      },
+      "IdConflict400": {
+        "value": {
+          "title": "Id Conflict",
+          "type": "https://api.commercecloud.salesforce.com/documentation/error/v1/errors/id-conflict",
+          "detail": "The ID in the request body ('his-promotion') doesn't match the ID in the URL ('my-promotion').",
+          "bodyID": "his-promotion",
+          "urlID": "my-promotion"
+        }
+      },
+      "PatchPromotion": {
+        "value": {
+          "enabled": false,
+          "name": {
+            "default": "__PROMOTION_ID__"
+          },
+          "exclusivity": "class",
+          "promotionClass": "order",
+          "c_customString": "Custom Value"
+        }
+      },
+      "examples-PatchPromotion": {
+        "value": {
+          "archived": false,
+          "assignmentInformation": {
+            "active": false,
+            "activeCampaignAssignments": [],
+            "campaignId": "coupon-campaign",
+            "enabled": false,
+            "schedule": {},
+            "scheduleType": "none"
+          },
+          "creationDate": "2020-01-13T20:22:09.189Z",
+          "disableGloballyExcluded": false,
+          "enabled": false,
+          "exclusivity": "class",
+          "id": "my-promotion",
+          "lastModified": "2020-01-13T20:31:25.795Z",
+          "name": {
+            "default": "__PROMOTION_ID__"
+          },
+          "promotionClass": "order",
+          "c_customString": "Custom Value"
+        }
+      },
+      "GetPromotionDiscountRule": {
+        "value": {
+          "promotionRule": {
+            "promotionClass": "order",
+            "discount": {
+              "type": "amount",
+              "amount": {
+                "currencyMnemonic": "USD",
+                "value": 15
+              }
+            },
+            "tiers": [
+              {
+                "threshold": 100,
+                "conditionType": "order_total",
+                "discount": {
+                  "type": "amount",
+                  "amount": {
+                    "currencyMnemonic": "USD",
+                    "value": 15
+                  }
+                }
+              }
+            ],
+            "discountOnlyQualifyingProducts": false,
+            "disableGlobalExcludedProducts": false
+          },
+          "qualifyingProducts": {
+            "includedProducts": [
+              {
+                "conditions": [
+                  {
+                    "type": "category",
+                    "operator": "is_equal",
+                    "catalogId": "storefront-catalog-m-en",
+                    "values": [
+                      "electronics"
+                    ]
+                  }
+                ]
+              }
+            ]
+          },
+          "paymentMethodQualifiers": {
+            "methodIds": [
+              "CREDIT_CARD.Visa"
+            ]
+          }
+        }
+      },
+      "PutPromotionDiscountRule": {
+        "value": {
+          "promotionRule": {
+            "promotionClass": "order",
+            "discount": {
+              "type": "amount",
+              "amount": {
+                "currencyMnemonic": "USD",
+                "value": 15
+              }
+            },
+            "tiers": [
+              {
+                "threshold": 100,
+                "conditionType": "order_total",
+                "discount": {
+                  "type": "amount",
+                  "amount": {
+                    "currencyMnemonic": "USD",
+                    "value": 15
+                  }
+                }
+              }
+            ]
+          },
+          "qualifyingProducts": {
+            "includedProducts": [
+              {
+                "conditions": [
+                  {
+                    "type": "category",
+                    "operator": "is_equal",
+                    "catalogId": "storefront-catalog-m-en",
+                    "values": [
+                      "electronics"
+                    ]
+                  }
+                ]
+              }
+            ]
+          }
+        }
+      },
+      "PatchPromotionDiscountRule": {
+        "value": {
+          "promotionRule": {
+            "promotionClass": "order",
+            "discount": {
+              "type": "percentage",
+              "percentage": 10
+            },
+            "discountOnlyQualifyingProducts": false,
+            "disableGlobalExcludedProducts": false
+          }
+        }
+      },
+      "GetPromotionCompatibility": {
+        "value": {
+          "exclusivity": "class",
+          "exclusivityGroup": "SummerSale",
+          "combinablePromotions": [
+            "10%offOrder"
+          ],
+          "mutuallyExclusivePromotions": [
+            "20%offOrder"
+          ]
+        }
+      },
+      "PutPromotionCompatibility": {
+        "value": {
+          "exclusivity": "class",
+          "exclusivityGroup": "SummerSale",
+          "combinablePromotions": [
+            "10%offOrder"
+          ],
+          "mutuallyExclusivePromotions": [
+            "20%offOrder"
+          ]
+        }
+      },
+      "PatchPromotionCompatibility": {
+        "value": {
+          "exclusivity": "class",
+          "exclusivityGroup": "SummerSale",
+          "combinablePromotions": [
+            "10%offOrder"
+          ],
+          "mutuallyExclusivePromotions": [
+            "20%offOrder"
+          ]
+        }
+      }
+    },
     "securitySchemes": {
       "AmOAuth2": {
         "type": "oauth2",
+        "description": "AccountManager OAuth 2.0 bearer token Authentication.",
         "flows": {
           "clientCredentials": {
             "tokenUrl": "https://account.demandware.com/dwsso/oauth2/access_token",
@@ -1312,10 +3356,8 @@
           "authorizationCode": {
             "authorizationUrl": "https://account.demandware.com/dwsso/oauth2/authorize",
             "tokenUrl": "https://account.demandware.com/dwsso/oauth2/access_token",
-            "scopes": {
-              "sfcc.promotions": "promotions READONLY",
-              "sfcc.promotions.rw": "promotions read/write"
-            }
+            "refreshUrl": "https://account.demandware.com/dwsso/oauth2/access_token",
+            "scopes": {}
           }
         }
       }