diff --git a/embedded/openapi/spec3.beta.sdk.json b/embedded/openapi/spec3.beta.sdk.json
index 056511e8..b237ccfd 100644
--- a/embedded/openapi/spec3.beta.sdk.json
+++ b/embedded/openapi/spec3.beta.sdk.json
@@ -57239,7 +57239,7 @@
                 "$ref": "#/components/schemas/discount"
               }
             ],
-            "description": "Describes the current discount applied to this subscription, if there is one. When billing, a discount applied to a subscription overrides a discount applied on a customer-wide basis.",
+            "description": "Describes the current discount applied to this subscription, if there is one. When billing, a discount applied to a subscription overrides a discount applied on a customer-wide basis. This field has been deprecated and will be removed in a future API version. Use `discounts` instead.",
             "nullable": true
           },
           "discounts": {
@@ -103844,7 +103844,7 @@
                               "type": "string"
                             },
                             "coupon": {
-                              "description": "The identifier of the coupon to apply to this phase of the subscription schedule.",
+                              "description": "The identifier of the coupon to apply to this phase of the subscription schedule. This field has been deprecated and will be removed in a future API version. Use `discounts` instead.",
                               "maxLength": 5000,
                               "type": "string"
                             },
@@ -107132,7 +107132,7 @@
                         "type": "string"
                       },
                       "coupon": {
-                        "description": "The identifier of the coupon to apply to this phase of the subscription schedule.",
+                        "description": "The identifier of the coupon to apply to this phase of the subscription schedule. This field has been deprecated and will be removed in a future API version. Use `discounts` instead.",
                         "maxLength": 5000,
                         "type": "string"
                       },
@@ -110408,7 +110408,7 @@
                         "type": "string"
                       },
                       "coupon": {
-                        "description": "The identifier of the coupon to apply to this phase of the subscription schedule.",
+                        "description": "The identifier of the coupon to apply to this phase of the subscription schedule. This field has been deprecated and will be removed in a future API version. Use `discounts` instead.",
                         "maxLength": 5000,
                         "type": "string"
                       },
@@ -171762,7 +171762,7 @@
                           "type": "string"
                         },
                         "coupon": {
-                          "description": "The identifier of the coupon to apply to this phase of the subscription schedule.",
+                          "description": "The identifier of the coupon to apply to this phase of the subscription schedule. This field has been deprecated and will be removed in a future API version. Use `discounts` instead.",
                           "maxLength": 5000,
                           "type": "string"
                         },
@@ -172961,7 +172961,7 @@
                           "type": "string"
                         },
                         "coupon": {
-                          "description": "The identifier of the coupon to apply to this phase of the subscription schedule.",
+                          "description": "The identifier of the coupon to apply to this phase of the subscription schedule. This field has been deprecated and will be removed in a future API version. Use `discounts` instead.",
                           "maxLength": 5000,
                           "type": "string"
                         },
@@ -175364,7 +175364,7 @@
                     "type": "string"
                   },
                   "coupon": {
-                    "description": "The ID of the coupon to apply to this subscription. A coupon applied to a subscription will only affect invoices created for that particular subscription.",
+                    "description": "The ID of the coupon to apply to this subscription. A coupon applied to a subscription will only affect invoices created for that particular subscription. This field has been deprecated and will be removed in a future API version. Use `discounts` instead.",
                     "maxLength": 5000,
                     "type": "string"
                   },
@@ -176230,7 +176230,7 @@
                     "type": "object"
                   },
                   "promotion_code": {
-                    "description": "The API ID of a promotion code to apply to this subscription. A promotion code applied to a subscription will only affect invoices created for that particular subscription.",
+                    "description": "The API ID of a promotion code to apply to this subscription. A promotion code applied to a subscription will only affect invoices created for that particular subscription. This field has been deprecated and will be removed in a future API version. Use `discounts` instead.",
                     "maxLength": 5000,
                     "type": "string"
                   },
@@ -177060,7 +177060,7 @@
                     "type": "string"
                   },
                   "coupon": {
-                    "description": "The ID of the coupon to apply to this subscription. A coupon applied to a subscription will only affect invoices created for that particular subscription.",
+                    "description": "The ID of the coupon to apply to this subscription. A coupon applied to a subscription will only affect invoices created for that particular subscription. This field has been deprecated and will be removed in a future API version. Use `discounts` instead.",
                     "maxLength": 5000,
                     "type": "string"
                   },