diff --git a/api-ref/source/v2/samples/version-show-response.json b/api-ref/source/v2/samples/version-show-response.json
index 77f64c3e225..3785a767322 100644
--- a/api-ref/source/v2/samples/version-show-response.json
+++ b/api-ref/source/v2/samples/version-show-response.json
@@ -1,20 +1,28 @@
 {
-    "choices": [
+    "versions": [
         {
-            "status": "SUPPORTED",
+            "status": "DEPRECATED",
+            "updated": "2017-02-25T12:00:00Z",
             "media-types": [
                 {
                     "base": "application/json",
-                    "type": "application/vnd.openstack.volume+json;version=1"
+                    "type": "application/vnd.openstack.volume+json;version=2"
                 }
             ],
             "id": "v2.0",
             "links": [
                 {
-                    "href": "http://23.253.248.171:8776/v2/v2.json",
+                    "href": "https://docs.openstack.org/",
+                    "type": "text/html",
+                    "rel": "describedby"
+                },
+                {
+                    "href": "http://23.253.248.171:8776/v2/",
                     "rel": "self"
                 }
-            ]
+            ],
+            "min_version": "",
+            "version": ""
         }
     ]
 }
diff --git a/api-ref/source/v2/volumes-v2-versions.inc b/api-ref/source/v2/volumes-v2-versions.inc
index 825fe975636..d47bd5f6017 100644
--- a/api-ref/source/v2/volumes-v2-versions.inc
+++ b/api-ref/source/v2/volumes-v2-versions.inc
@@ -9,7 +9,7 @@ API versions
 Show API v2 details
 ~~~~~~~~~~~~~~~~~~~
 
-.. rest_method::  GET /v2
+.. rest_method::  GET /v2/
 
 Shows details for Block Storage API v2.