diff --git a/openapi/spec3.beta.sdk.json b/openapi/spec3.beta.sdk.json
index 630863b7..74698a21 100644
--- a/openapi/spec3.beta.sdk.json
+++ b/openapi/spec3.beta.sdk.json
@@ -108684,11 +108684,11 @@
     },
     "/v1/payment_intents/{intent}": {
       "get": {
-        "description": "<p>Retrieves the details of a PaymentIntent that has previously been created. </p>\n\n<p>Client-side retrieval using a publishable key is allowed when the <code>client_secret</code> is provided in the query string. </p>\n\n<p>When retrieved with a publishable key, only a subset of properties will be returned. Please refer to the <a href=\"#payment_intent_object\">payment intent</a> object reference for more details.</p>",
+        "description": "<p>Retrieves the details of a PaymentIntent that has previously been created. </p>\n\n<p>You can retrieve a PaymentIntent client-side using a publishable key when the <code>client_secret</code> is in the query string. </p>\n\n<p>If you retrieve a PaymentIntent with a publishable key, it only returns a subset of properties. Refer to the <a href=\"#payment_intent_object\">payment intent</a> object reference for more details.</p>",
         "operationId": "GetPaymentIntentsIntent",
         "parameters": [
           {
-            "description": "The client secret of the PaymentIntent. Required if a publishable key is used to retrieve the source.",
+            "description": "The client secret of the PaymentIntent. It's required if you use a publishable key to retrieve the source.",
             "in": "query",
             "name": "client_secret",
             "required": false,
diff --git a/openapi/spec3.beta.sdk.yaml b/openapi/spec3.beta.sdk.yaml
index d875046b..7d09c4e8 100644
--- a/openapi/spec3.beta.sdk.yaml
+++ b/openapi/spec3.beta.sdk.yaml
@@ -101087,19 +101087,19 @@ paths:
         created. </p>
 
 
-        <p>Client-side retrieval using a publishable key is allowed when the
-        <code>client_secret</code> is provided in the query string. </p>
+        <p>You can retrieve a PaymentIntent client-side using a publishable key
+        when the <code>client_secret</code> is in the query string. </p>
 
 
-        <p>When retrieved with a publishable key, only a subset of properties
-        will be returned. Please refer to the <a
+        <p>If you retrieve a PaymentIntent with a publishable key, it only
+        returns a subset of properties. Refer to the <a
         href="#payment_intent_object">payment intent</a> object reference for
         more details.</p>
       operationId: GetPaymentIntentsIntent
       parameters:
         - description: >-
-            The client secret of the PaymentIntent. Required if a publishable
-            key is used to retrieve the source.
+            The client secret of the PaymentIntent. It's required if you use a
+            publishable key to retrieve the source.
           in: query
           name: client_secret
           required: false
diff --git a/openapi/spec3.json b/openapi/spec3.json
index b183ad7b..e8cb99a6 100644
--- a/openapi/spec3.json
+++ b/openapi/spec3.json
@@ -88572,11 +88572,11 @@
     },
     "/v1/payment_intents/{intent}": {
       "get": {
-        "description": "<p>Retrieves the details of a PaymentIntent that has previously been created. </p>\n\n<p>Client-side retrieval using a publishable key is allowed when the <code>client_secret</code> is provided in the query string. </p>\n\n<p>When retrieved with a publishable key, only a subset of properties will be returned. Please refer to the <a href=\"#payment_intent_object\">payment intent</a> object reference for more details.</p>",
+        "description": "<p>Retrieves the details of a PaymentIntent that has previously been created. </p>\n\n<p>You can retrieve a PaymentIntent client-side using a publishable key when the <code>client_secret</code> is in the query string. </p>\n\n<p>If you retrieve a PaymentIntent with a publishable key, it only returns a subset of properties. Refer to the <a href=\"#payment_intent_object\">payment intent</a> object reference for more details.</p>",
         "operationId": "GetPaymentIntentsIntent",
         "parameters": [
           {
-            "description": "The client secret of the PaymentIntent. Required if a publishable key is used to retrieve the source.",
+            "description": "The client secret of the PaymentIntent. It's required if you use a publishable key to retrieve the source.",
             "in": "query",
             "name": "client_secret",
             "required": false,
diff --git a/openapi/spec3.sdk.json b/openapi/spec3.sdk.json
index 1d276568..768fcc3f 100644
--- a/openapi/spec3.sdk.json
+++ b/openapi/spec3.sdk.json
@@ -91172,11 +91172,11 @@
     },
     "/v1/payment_intents/{intent}": {
       "get": {
-        "description": "<p>Retrieves the details of a PaymentIntent that has previously been created. </p>\n\n<p>Client-side retrieval using a publishable key is allowed when the <code>client_secret</code> is provided in the query string. </p>\n\n<p>When retrieved with a publishable key, only a subset of properties will be returned. Please refer to the <a href=\"#payment_intent_object\">payment intent</a> object reference for more details.</p>",
+        "description": "<p>Retrieves the details of a PaymentIntent that has previously been created. </p>\n\n<p>You can retrieve a PaymentIntent client-side using a publishable key when the <code>client_secret</code> is in the query string. </p>\n\n<p>If you retrieve a PaymentIntent with a publishable key, it only returns a subset of properties. Refer to the <a href=\"#payment_intent_object\">payment intent</a> object reference for more details.</p>",
         "operationId": "GetPaymentIntentsIntent",
         "parameters": [
           {
-            "description": "The client secret of the PaymentIntent. Required if a publishable key is used to retrieve the source.",
+            "description": "The client secret of the PaymentIntent. It's required if you use a publishable key to retrieve the source.",
             "in": "query",
             "name": "client_secret",
             "required": false,
diff --git a/openapi/spec3.sdk.yaml b/openapi/spec3.sdk.yaml
index d2872add..5bd79a12 100644
--- a/openapi/spec3.sdk.yaml
+++ b/openapi/spec3.sdk.yaml
@@ -84600,19 +84600,19 @@ paths:
         created. </p>
 
 
-        <p>Client-side retrieval using a publishable key is allowed when the
-        <code>client_secret</code> is provided in the query string. </p>
+        <p>You can retrieve a PaymentIntent client-side using a publishable key
+        when the <code>client_secret</code> is in the query string. </p>
 
 
-        <p>When retrieved with a publishable key, only a subset of properties
-        will be returned. Please refer to the <a
+        <p>If you retrieve a PaymentIntent with a publishable key, it only
+        returns a subset of properties. Refer to the <a
         href="#payment_intent_object">payment intent</a> object reference for
         more details.</p>
       operationId: GetPaymentIntentsIntent
       parameters:
         - description: >-
-            The client secret of the PaymentIntent. Required if a publishable
-            key is used to retrieve the source.
+            The client secret of the PaymentIntent. It's required if you use a
+            publishable key to retrieve the source.
           in: query
           name: client_secret
           required: false
diff --git a/openapi/spec3.yaml b/openapi/spec3.yaml
index 61378155..bbb0d458 100644
--- a/openapi/spec3.yaml
+++ b/openapi/spec3.yaml
@@ -76670,19 +76670,19 @@ paths:
         created. </p>
 
 
-        <p>Client-side retrieval using a publishable key is allowed when the
-        <code>client_secret</code> is provided in the query string. </p>
+        <p>You can retrieve a PaymentIntent client-side using a publishable key
+        when the <code>client_secret</code> is in the query string. </p>
 
 
-        <p>When retrieved with a publishable key, only a subset of properties
-        will be returned. Please refer to the <a
+        <p>If you retrieve a PaymentIntent with a publishable key, it only
+        returns a subset of properties. Refer to the <a
         href="#payment_intent_object">payment intent</a> object reference for
         more details.</p>
       operationId: GetPaymentIntentsIntent
       parameters:
         - description: >-
-            The client secret of the PaymentIntent. Required if a publishable
-            key is used to retrieve the source.
+            The client secret of the PaymentIntent. It's required if you use a
+            publishable key to retrieve the source.
           in: query
           name: client_secret
           required: false