diff --git a/api-ref/v1/source/parameters.yaml b/api-ref/v1/source/parameters.yaml
index 6409f2faa9e..f3f5b96c668 100644
--- a/api-ref/v1/source/parameters.yaml
+++ b/api-ref/v1/source/parameters.yaml
@@ -481,7 +481,7 @@ reserved_1:
   in: body
   required: true
   type: integer
-scheduler_hints:
+OS-SCH-HNT:scheduler_hints:
   description: |
     The dictionary of data to send to the scheduler.
   in: body
diff --git a/api-ref/v1/source/samples/volume-create-request.json b/api-ref/v1/source/samples/volume-create-request.json
index fbbfe360cf2..171a68c39ca 100644
--- a/api-ref/v1/source/samples/volume-create-request.json
+++ b/api-ref/v1/source/samples/volume-create-request.json
@@ -8,5 +8,11 @@
             "contents": "junk"
         },
         "availability_zone": "us-east1"
+    },
+    "OS-SCH-HNT:scheduler_hints": {
+        "same_host": [
+            "a0cf03a5-d921-4877-bb5c-86d26cf818e1",
+            "8c19174f-4220-44f0-824a-cd1eeef10287"
+        ]
     }
 }
diff --git a/api-ref/v1/source/volumes-v1-volumes.inc b/api-ref/v1/source/volumes-v1-volumes.inc
index f1dfcade9dc..38d4fdb61e3 100644
--- a/api-ref/v1/source/volumes-v1-volumes.inc
+++ b/api-ref/v1/source/volumes-v1-volumes.inc
@@ -91,7 +91,7 @@ Request
    - consistencygroup_id: consistencygroup_id
    - volume_type: volume_type
    - snapshot_id: snapshot_id
-   - scheduler_hints: scheduler_hints
+   - OS-SCH-HNT:scheduler_hints: OS-SCH-HNT:scheduler_hints
    - source_replica: source_replica
    - metadata: metadata
    - tenant_id: tenant_id
diff --git a/api-ref/v2/source/parameters.yaml b/api-ref/v2/source/parameters.yaml
index c1caa17ea2c..02a7d153cc9 100644
--- a/api-ref/v2/source/parameters.yaml
+++ b/api-ref/v2/source/parameters.yaml
@@ -1236,7 +1236,7 @@ restore:
   in: body
   required: true
   type: object
-scheduler_hints:
+OS-SCH-HNT:scheduler_hints:
   description: |
     The dictionary of data to send to the scheduler.
   in: body
diff --git a/api-ref/v2/source/samples/volume-create-request.json b/api-ref/v2/source/samples/volume-create-request.json
index 38c12d9a779..2aab202523f 100644
--- a/api-ref/v2/source/samples/volume-create-request.json
+++ b/api-ref/v2/source/samples/volume-create-request.json
@@ -12,5 +12,11 @@
         "metadata": {},
         "source_replica": null,
         "consistencygroup_id": null
+    },
+    "OS-SCH-HNT:scheduler_hints": {
+        "same_host": [
+            "a0cf03a5-d921-4877-bb5c-86d26cf818e1",
+            "8c19174f-4220-44f0-824a-cd1eeef10287"
+        ]
     }
 }
diff --git a/api-ref/v2/source/volumes-v2-volumes.inc b/api-ref/v2/source/volumes-v2-volumes.inc
index cb8da961d1c..53a3f517dd2 100644
--- a/api-ref/v2/source/volumes-v2-volumes.inc
+++ b/api-ref/v2/source/volumes-v2-volumes.inc
@@ -167,7 +167,7 @@ Request
    - consistencygroup_id: consistencygroup_id
    - volume_type: volume_type
    - snapshot_id: snapshot_id
-   - scheduler_hints: scheduler_hints
+   - OS-SCH-HNT:scheduler_hints: OS-SCH-HNT:scheduler_hints
    - source_replica: source_replica
    - metadata: metadata
    - tenant_id: tenant_id