diff --git a/openapi/spec3.beta.sdk.json b/openapi/spec3.beta.sdk.json
index 356cd229..d9ea57d1 100644
--- a/openapi/spec3.beta.sdk.json
+++ b/openapi/spec3.beta.sdk.json
@@ -64372,7 +64372,7 @@
         }
       },
       "post": {
-        "description": "<p>Updates an existing Account Capability.</p>",
+        "description": "<p>Updates an existing Account Capability. Request or remove a capability by updating its <code>requested</code> parameter.</p>",
         "operationId": "PostAccountsAccountCapabilitiesCapability",
         "parameters": [
           {
@@ -64416,7 +64416,7 @@
                     "type": "array"
                   },
                   "requested": {
-                    "description": "Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.",
+                    "description": "To request a new capability for an account, pass true. There can be a delay before the requested capability becomes active. If the capability has any activation requirements, the response includes them in the `requirements` arrays.\n\nIf a capability isn't permanent, you can remove it from the account by passing false. Most capabilities are permanent after they've been requested. Attempting to remove a permanent capability returns an error.",
                     "type": "boolean"
                   }
                 },
diff --git a/openapi/spec3.beta.sdk.yaml b/openapi/spec3.beta.sdk.yaml
index 5343dc58..713a7b9d 100644
--- a/openapi/spec3.beta.sdk.yaml
+++ b/openapi/spec3.beta.sdk.yaml
@@ -58919,7 +58919,9 @@ paths:
                 $ref: '#/components/schemas/error'
           description: Error response.
     post:
-      description: <p>Updates an existing Account Capability.</p>
+      description: >-
+        <p>Updates an existing Account Capability. Request or remove a
+        capability by updating its <code>requested</code> parameter.</p>
       operationId: PostAccountsAccountCapabilitiesCapability
       parameters:
         - in: path
@@ -58953,10 +58955,16 @@ paths:
                   type: array
                 requested:
                   description: >-
-                    Passing true requests the capability for the account, if it
-                    is not already requested. A requested capability may not
-                    immediately become active. Any requirements to activate the
-                    capability are returned in the `requirements` arrays.
+                    To request a new capability for an account, pass true. There
+                    can be a delay before the requested capability becomes
+                    active. If the capability has any activation requirements,
+                    the response includes them in the `requirements` arrays.
+
+
+                    If a capability isn't permanent, you can remove it from the
+                    account by passing false. Most capabilities are permanent
+                    after they've been requested. Attempting to remove a
+                    permanent capability returns an error.
                   type: boolean
               type: object
         required: false
diff --git a/openapi/spec3.json b/openapi/spec3.json
index 0e7c760a..aa964a69 100644
--- a/openapi/spec3.json
+++ b/openapi/spec3.json
@@ -46659,7 +46659,7 @@
         }
       },
       "post": {
-        "description": "<p>Updates an existing Account Capability.</p>",
+        "description": "<p>Updates an existing Account Capability. Request or remove a capability by updating its <code>requested</code> parameter.</p>",
         "operationId": "PostAccountsAccountCapabilitiesCapability",
         "parameters": [
           {
@@ -46703,7 +46703,7 @@
                     "type": "array"
                   },
                   "requested": {
-                    "description": "Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.",
+                    "description": "To request a new capability for an account, pass true. There can be a delay before the requested capability becomes active. If the capability has any activation requirements, the response includes them in the `requirements` arrays.\n\nIf a capability isn't permanent, you can remove it from the account by passing false. Most capabilities are permanent after they've been requested. Attempting to remove a permanent capability returns an error.",
                     "type": "boolean"
                   }
                 },
diff --git a/openapi/spec3.sdk.json b/openapi/spec3.sdk.json
index d9ef226e..e7581297 100644
--- a/openapi/spec3.sdk.json
+++ b/openapi/spec3.sdk.json
@@ -55567,7 +55567,7 @@
         }
       },
       "post": {
-        "description": "<p>Updates an existing Account Capability.</p>",
+        "description": "<p>Updates an existing Account Capability. Request or remove a capability by updating its <code>requested</code> parameter.</p>",
         "operationId": "PostAccountsAccountCapabilitiesCapability",
         "parameters": [
           {
@@ -55611,7 +55611,7 @@
                     "type": "array"
                   },
                   "requested": {
-                    "description": "Passing true requests the capability for the account, if it is not already requested. A requested capability may not immediately become active. Any requirements to activate the capability are returned in the `requirements` arrays.",
+                    "description": "To request a new capability for an account, pass true. There can be a delay before the requested capability becomes active. If the capability has any activation requirements, the response includes them in the `requirements` arrays.\n\nIf a capability isn't permanent, you can remove it from the account by passing false. Most capabilities are permanent after they've been requested. Attempting to remove a permanent capability returns an error.",
                     "type": "boolean"
                   }
                 },
diff --git a/openapi/spec3.sdk.yaml b/openapi/spec3.sdk.yaml
index e215ec19..e73a45e1 100644
--- a/openapi/spec3.sdk.yaml
+++ b/openapi/spec3.sdk.yaml
@@ -51232,7 +51232,9 @@ paths:
                 $ref: '#/components/schemas/error'
           description: Error response.
     post:
-      description: <p>Updates an existing Account Capability.</p>
+      description: >-
+        <p>Updates an existing Account Capability. Request or remove a
+        capability by updating its <code>requested</code> parameter.</p>
       operationId: PostAccountsAccountCapabilitiesCapability
       parameters:
         - in: path
@@ -51266,10 +51268,16 @@ paths:
                   type: array
                 requested:
                   description: >-
-                    Passing true requests the capability for the account, if it
-                    is not already requested. A requested capability may not
-                    immediately become active. Any requirements to activate the
-                    capability are returned in the `requirements` arrays.
+                    To request a new capability for an account, pass true. There
+                    can be a delay before the requested capability becomes
+                    active. If the capability has any activation requirements,
+                    the response includes them in the `requirements` arrays.
+
+
+                    If a capability isn't permanent, you can remove it from the
+                    account by passing false. Most capabilities are permanent
+                    after they've been requested. Attempting to remove a
+                    permanent capability returns an error.
                   type: boolean
               type: object
         required: false
diff --git a/openapi/spec3.yaml b/openapi/spec3.yaml
index f09f47b7..80778a8d 100644
--- a/openapi/spec3.yaml
+++ b/openapi/spec3.yaml
@@ -42949,7 +42949,9 @@ paths:
                 $ref: '#/components/schemas/error'
           description: Error response.
     post:
-      description: <p>Updates an existing Account Capability.</p>
+      description: >-
+        <p>Updates an existing Account Capability. Request or remove a
+        capability by updating its <code>requested</code> parameter.</p>
       operationId: PostAccountsAccountCapabilitiesCapability
       parameters:
         - in: path
@@ -42983,10 +42985,16 @@ paths:
                   type: array
                 requested:
                   description: >-
-                    Passing true requests the capability for the account, if it
-                    is not already requested. A requested capability may not
-                    immediately become active. Any requirements to activate the
-                    capability are returned in the `requirements` arrays.
+                    To request a new capability for an account, pass true. There
+                    can be a delay before the requested capability becomes
+                    active. If the capability has any activation requirements,
+                    the response includes them in the `requirements` arrays.
+
+
+                    If a capability isn't permanent, you can remove it from the
+                    account by passing false. Most capabilities are permanent
+                    after they've been requested. Attempting to remove a
+                    permanent capability returns an error.
                   type: boolean
               type: object
         required: false