diff --git a/embedded/openapi/spec3.beta.sdk.json b/embedded/openapi/spec3.beta.sdk.json
index 5264d7f2..8312bba3 100644
--- a/embedded/openapi/spec3.beta.sdk.json
+++ b/embedded/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/embedded/openapi/spec3.json b/embedded/openapi/spec3.json
index ec3f22aa..08087a65 100644
--- a/embedded/openapi/spec3.json
+++ b/embedded/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"