diff --git a/api-ref/source/v3/samples/snapshot-create-request.json b/api-ref/source/v3/samples/snapshot-create-request.json
index 3c0fe5d888f..5fb46cd0c29 100644
--- a/api-ref/source/v3/samples/snapshot-create-request.json
+++ b/api-ref/source/v3/samples/snapshot-create-request.json
@@ -3,6 +3,7 @@
         "name": "snap-001",
         "description": "Daily backup",
         "volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
-        "force": true
+        "force": true,
+        "metadata": null
     }
 }
diff --git a/api-ref/source/v3/samples/snapshot-create-response.json b/api-ref/source/v3/samples/snapshot-create-response.json
index 6f6cc931017..15a139531a7 100644
--- a/api-ref/source/v3/samples/snapshot-create-response.json
+++ b/api-ref/source/v3/samples/snapshot-create-response.json
@@ -4,6 +4,7 @@
         "description": "Daily backup",
         "created_at": "2013-02-25T03:56:53.081642",
         "metadata": {},
+        "updated_at": "2013-02-25T03:58:53.081642",
         "volume_id": "5aa119a8-d25b-45a7-8d1b-88e127885635",
         "size": 1,
         "user_id": "40c2102f4a554b848d96b14f3eec39ed",
@@ -11,3 +12,4 @@
         "name": "snap-001"
     }
 }
+
diff --git a/api-ref/source/v3/volumes-v3-snapshots.inc b/api-ref/source/v3/volumes-v3-snapshots.inc
index e7639434bcb..13643c0528f 100644
--- a/api-ref/source/v3/volumes-v3-snapshots.inc
+++ b/api-ref/source/v3/volumes-v3-snapshots.inc
@@ -100,6 +100,7 @@ Request
    - description: description
    - name: name
    - project_id: project_id_path
+   - metadata: metadata_7
 
 Request Example
 ---------------
@@ -122,6 +123,13 @@ Response Parameters
    - metadata: metadata
    - id: id
    - size: size
+   - updated_at: updated_at
+
+Response Example
+----------------
+
+.. literalinclude:: ./samples/snapshot-create-response.json
+   :language: javascript
 
 
 List accessible snapshots