diff --git a/openapi.yaml b/openapi.yaml
index a316a90fb..94a9b0c9b 100644
--- a/openapi.yaml
+++ b/openapi.yaml
@@ -6336,6 +6336,7 @@ paths:
 
           * Gives up any IP addresses the Linode was assigned.
           * Deletes all Disks, Backups, Configs, etc.
+          * Detaches any Volumes associated with the Linode.
           * Stops billing for the Linode and its associated services. You will be billed for time used
             within the billing period the Linode was active.
 
@@ -18506,11 +18507,10 @@ paths:
     x-linode-cli-command: volumes
     post:
       summary: Volume Detach
-      description: >
-        Detaches a Volume on your Account
-        from a Linode on your Account. In order for this request to
-        complete successfully, your User must have `read_write` access to the
-        Volume and `read_write` access to the Linode.
+      description: |
+        Detaches a Volume on your Account from a Linode on your Account. In order for this request to complete successfully, your User must have `read_write` access to the Volume and `read_write` access to the Linode.
+
+        Volumes are automatically detached from deleted Linodes.
       tags:
       - Volumes
       operationId: detachVolume