diff --git a/doc/api/garage-admin-v1.yml b/doc/api/garage-admin-v1.yml
index 078da5da..063bc382 100644
--- a/doc/api/garage-admin-v1.yml
+++ b/doc/api/garage-admin-v1.yml
@@ -348,7 +348,7 @@ paths:
             application/json:
               schema:
                 $ref: '#/components/schemas/KeyInfo'
-          
+
   "/key":
     get:
       tags:
@@ -409,8 +409,8 @@ paths:
       description: |
        Delete a key from the cluster. Its access will be removed from all the buckets. Buckets are not automatically deleted and can be dangling. You should manually delete them before. 
       parameters:
-        - name: access_key
-          in: path
+        - name: id
+          in: query
           required: true
           description: "The exact API access key generated by Garage"
           example: "GK31c2f218a2e44f485b94239e"
@@ -433,8 +433,8 @@ paths:
 
         *Note: the secret key is not returned in the response, `null` is sent instead.*
       parameters:
-        - name: access_key
-          in: path
+        - name: id
+          in: query
           required: true
           description: "The exact API access key generated by Garage"
           example: "GK31c2f218a2e44f485b94239e"