diff --git a/api-ref/source/v1/parameters.yaml b/api-ref/source/v1/parameters.yaml
index 6fce60bb5e..f8605d8d54 100644
--- a/api-ref/source/v1/parameters.yaml
+++ b/api-ref/source/v1/parameters.yaml
@@ -1591,6 +1591,23 @@ updated_time:
   in: body
   required: true
   type: string
+version_id:
+  type: string
+  in: body
+  required: true
+  description: >
+    A common name for the version in question. Informative only, it
+    has no real semantic meaning.
+version_status:
+  type: string
+  in: body
+  required: true
+  description: |
+    The status of this API version. This can be one of:
+
+    - ``CURRENT``: this is the preferred version of the API to use
+    - ``SUPPORTED``: this is an older, but still supported version of the API
+    - ``DEPRECATED``: a deprecated version of the API that is slated for removal
 versions:
   description: |
     A list of all orchestration API versions. Each object in the list provides
diff --git a/api-ref/source/v1/versions.inc b/api-ref/source/v1/versions.inc
index 4b1d5f23a6..8fbcaa5e59 100644
--- a/api-ref/source/v1/versions.inc
+++ b/api-ref/source/v1/versions.inc
@@ -23,13 +23,16 @@ Request Parameters
 
 This operation does not accept a request body.
 
-Request Parameters
+Response Parameters
 ------------------
 
 .. rest_parameters:: parameters.yaml
 
    - X-Openstack-Request-Id: request_id
    - versions: versions
+   - id: version_id
+   - status: version_status
+   - links: links
 
 Response Example
 ----------------