diff --git a/api-ref/source/v3/parameters.yaml b/api-ref/source/v3/parameters.yaml
index 6d94c1edbfa..f0344ade3f0 100644
--- a/api-ref/source/v3/parameters.yaml
+++ b/api-ref/source/v3/parameters.yaml
@@ -1043,7 +1043,7 @@ extra_specs_1:
     include capabilities, capacity, compression, and so on, depending
     on the storage driver in use.
   in: body
-  required: true
+  required: false
   type: object
 fail_reason:
   description: |
@@ -1834,6 +1834,12 @@ name_9:
   in: body
   required: true
   type: string
+name_10:
+  description: |
+    The name of the volume type.
+  in: body
+  required: false
+  type: string
 name_optional:
   description: |
     The name of the Volume Backup.
diff --git a/api-ref/source/v3/samples/volume-type-create-request.json b/api-ref/source/v3/samples/volume-type-create-request.json
index 94ab0449ef5..13d86bfdf5b 100644
--- a/api-ref/source/v3/samples/volume-type-create-request.json
+++ b/api-ref/source/v3/samples/volume-type-create-request.json
@@ -2,6 +2,9 @@
     "volume_type": {
         "name": "vol-type-001",
         "description": "volume type 0001",
-        "is_public": true,
+        "os-volume-type-access:is_public": true,
+        "extra_specs": {
+            "capabilities": "gpu"
+        }
     }
 }
diff --git a/api-ref/source/v3/samples/volume-type-update-request.json b/api-ref/source/v3/samples/volume-type-update-request.json
index 8bdc5befb3b..1c9dc19f881 100644
--- a/api-ref/source/v3/samples/volume-type-update-request.json
+++ b/api-ref/source/v3/samples/volume-type-update-request.json
@@ -2,9 +2,6 @@
     "volume_type": {
         "name": "vol-type-001",
         "description": "volume type 0001",
-        "is_public": true,
-        "extra_specs": {
-            "capabilities": "gpu"
-        }
+        "is_public": true
     }
 }
diff --git a/api-ref/source/v3/volumes-v3-types.inc b/api-ref/source/v3/volumes-v3-types.inc
index 7d0ba080c31..888a3958df2 100644
--- a/api-ref/source/v3/volumes-v3-types.inc
+++ b/api-ref/source/v3/volumes-v3-types.inc
@@ -36,10 +36,9 @@ Request
    - project_id: project_id_path
    - volume_type_id: volume_type_id
    - volume_type: volume_type_1
-   - name: name_7
+   - name: name_10
    - description: description_15
    - is_public: is_public
-   - extra_specs: extra_specs
 
 Request Example
 ---------------
@@ -355,8 +354,9 @@ Request
    - volume_type: volume_type_1
    - project_id: project_id_path
    - name: name_7
-   - is_public: is_public
+   - os-volume-type-access:is_public: is_public
    - description: description_15
+   - extra_specs: extra_specs_1
 
 Request Example
 ---------------