diff --git a/openapi/spec3.beta.sdk.json b/openapi/spec3.beta.sdk.json
index 5264d7f2..8312bba3 100644
--- a/openapi/spec3.beta.sdk.json
+++ b/openapi/spec3.beta.sdk.json
@@ -23466,7 +23466,7 @@
             "x-stripeBypassValidation": true
           },
           "reason_message": {
-            "description": "If approve/decline decision is directly responsed to the webhook with json payload and if the response is invalid (e.g., parsing errors), we surface the detailed message via this field.",
+            "description": "If the `request_history.reason` is `webhook_error` because the direct webhook response is invalid (for example, parsing errors or missing parameters), we surface a more detailed error message via this field.",
             "maxLength": 5000,
             "nullable": true,
             "type": "string"
diff --git a/openapi/spec3.beta.sdk.yaml b/openapi/spec3.beta.sdk.yaml
index 9bac6a66..afb854ed 100644
--- a/openapi/spec3.beta.sdk.yaml
+++ b/openapi/spec3.beta.sdk.yaml
@@ -21260,9 +21260,10 @@ components:
           x-stripeBypassValidation: true
         reason_message:
           description: >-
-            If approve/decline decision is directly responsed to the webhook
-            with json payload and if the response is invalid (e.g., parsing
-            errors), we surface the detailed message via this field.
+            If the `request_history.reason` is `webhook_error` because the
+            direct webhook response is invalid (for example, parsing errors or
+            missing parameters), we surface a more detailed error message via
+            this field.
           maxLength: 5000
           nullable: true
           type: string
diff --git a/openapi/spec3.json b/openapi/spec3.json
index ec3f22aa..08087a65 100644
--- a/openapi/spec3.json
+++ b/openapi/spec3.json
@@ -14851,7 +14851,7 @@
             "x-stripeBypassValidation": true
           },
           "reason_message": {
-            "description": "If approve/decline decision is directly responsed to the webhook with json payload and if the response is invalid (e.g., parsing errors), we surface the detailed message via this field.",
+            "description": "If the `request_history.reason` is `webhook_error` because the direct webhook response is invalid (for example, parsing errors or missing parameters), we surface a more detailed error message via this field.",
             "maxLength": 5000,
             "nullable": true,
             "type": "string"
diff --git a/openapi/spec3.sdk.json b/openapi/spec3.sdk.json
index 0b531107..50fda4b9 100644
--- a/openapi/spec3.sdk.json
+++ b/openapi/spec3.sdk.json
@@ -19761,7 +19761,7 @@
             "x-stripeBypassValidation": true
           },
           "reason_message": {
-            "description": "If approve/decline decision is directly responsed to the webhook with json payload and if the response is invalid (e.g., parsing errors), we surface the detailed message via this field.",
+            "description": "If the `request_history.reason` is `webhook_error` because the direct webhook response is invalid (for example, parsing errors or missing parameters), we surface a more detailed error message via this field.",
             "maxLength": 5000,
             "nullable": true,
             "type": "string"
diff --git a/openapi/spec3.sdk.yaml b/openapi/spec3.sdk.yaml
index 4ebc2fa4..40cc19da 100644
--- a/openapi/spec3.sdk.yaml
+++ b/openapi/spec3.sdk.yaml
@@ -18043,9 +18043,10 @@ components:
           x-stripeBypassValidation: true
         reason_message:
           description: >-
-            If approve/decline decision is directly responsed to the webhook
-            with json payload and if the response is invalid (e.g., parsing
-            errors), we surface the detailed message via this field.
+            If the `request_history.reason` is `webhook_error` because the
+            direct webhook response is invalid (for example, parsing errors or
+            missing parameters), we surface a more detailed error message via
+            this field.
           maxLength: 5000
           nullable: true
           type: string
diff --git a/openapi/spec3.yaml b/openapi/spec3.yaml
index c450291d..7d2f1225 100644
--- a/openapi/spec3.yaml
+++ b/openapi/spec3.yaml
@@ -14258,9 +14258,10 @@ components:
           x-stripeBypassValidation: true
         reason_message:
           description: >-
-            If approve/decline decision is directly responsed to the webhook
-            with json payload and if the response is invalid (e.g., parsing
-            errors), we surface the detailed message via this field.
+            If the `request_history.reason` is `webhook_error` because the
+            direct webhook response is invalid (for example, parsing errors or
+            missing parameters), we surface a more detailed error message via
+            this field.
           maxLength: 5000
           nullable: true
           type: string