diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index c28dadf248f8..59bda07f36dd 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -3773,13 +3773,13 @@ OS-SRV-USG:terminated_at:
   type: string
 os-start:
   description: |
-    The action.
+    The action to start a stopped server.
   in: body
   required: true
   type: none
 os-stop:
   description: |
-    The action.
+    The action to stop a running server.
   in: body
   required: true
   type: none
@@ -4714,7 +4714,7 @@ subnet_id:
   type: string
 suspend:
   description: |
-    The action.
+    The action to suspend a server.
   in: body
   required: true
   type: none
@@ -4808,19 +4808,19 @@ type-os-assisted-volume-snapshot:
   type: string
 unlock:
   description: |
-    The action.
+    The action to unlock a locked server.
   in: body
   required: true
   type: none
 unpause:
   description: |
-    The action.
+    The action to unpause a paused server.
   in: body
   required: true
   type: none
 unrescue:
   description: |
-    The action.
+    The action to unrescue a server in rescue mode.
   in: body
   required: true
   type: none