diff --git a/api-ref/src/docbkx/ch_blockstorage-api-v2.xml b/api-ref/src/docbkx/ch_blockstorage-api-v2.xml
index c93da030e..7b0bb11e6 100644
--- a/api-ref/src/docbkx/ch_blockstorage-api-v2.xml
+++ b/api-ref/src/docbkx/ch_blockstorage-api-v2.xml
@@ -177,6 +177,8 @@
                 <wadl:method href="#attachVolume"/>
                 <wadl:method href="#unmanageVolume"/>
                 <wadl:method href="#forcedetachVolume"/>
+                <wadl:method href="#promotereplicaVolume"/>
+                <wadl:method href="#reenablereplicaVolume"/>
             </wadl:resource>
         </wadl:resources>
     </section>
diff --git a/api-ref/src/wadls/volume-api/src/v2/api_samples/os-replica/os-promote-replica-request.json b/api-ref/src/wadls/volume-api/src/v2/api_samples/os-replica/os-promote-replica-request.json
new file mode 100644
index 000000000..9ed522325
--- /dev/null
+++ b/api-ref/src/wadls/volume-api/src/v2/api_samples/os-replica/os-promote-replica-request.json
@@ -0,0 +1,3 @@
+{
+    "os-promote-replica": {}
+}
diff --git a/api-ref/src/wadls/volume-api/src/v2/api_samples/os-replica/os-reenable-replica-request.json b/api-ref/src/wadls/volume-api/src/v2/api_samples/os-replica/os-reenable-replica-request.json
new file mode 100644
index 000000000..d622b08ca
--- /dev/null
+++ b/api-ref/src/wadls/volume-api/src/v2/api_samples/os-replica/os-reenable-replica-request.json
@@ -0,0 +1,3 @@
+{
+    "os-reenable-replica": {}
+}
diff --git a/api-ref/src/wadls/volume-api/src/v2/api_samples/volume_list_detail_response.json b/api-ref/src/wadls/volume-api/src/v2/api_samples/volume_list_detail_response.json
index 2f23092e1..c12a9f170 100644
--- a/api-ref/src/wadls/volume-api/src/v2/api_samples/volume_list_detail_response.json
+++ b/api-ref/src/wadls/volume-api/src/v2/api_samples/volume_list_detail_response.json
@@ -24,6 +24,8 @@
             "volume_type": "None",
             "os-vol-tenant-attr:tenant_id": "0c2eba2c5af04d3f9e9d0d410b371fde",
             "size": 1,
+            "os-volume-replication:driver_data": null,
+            "os-volume-replication:extended_status": null,
             "metadata": {
                 "contents": "junk"
             }
@@ -52,9 +54,11 @@
             "volume_type": "None",
             "os-vol-tenant-attr:tenant_id": "0c2eba2c5af04d3f9e9d0d410b371fde",
             "size": 1,
+            "os-volume-replication:driver_data": null,
+            "os-volume-replication:extended_status": null,
             "metadata": {
                 "contents": "not junk"
             }
         }
     ]
-}
\ No newline at end of file
+}
diff --git a/api-ref/src/wadls/volume-api/src/v2/api_samples/volume_show_response.json b/api-ref/src/wadls/volume-api/src/v2/api_samples/volume_show_response.json
index 3b0daf6ce..f9d73aae8 100644
--- a/api-ref/src/wadls/volume-api/src/v2/api_samples/volume_show_response.json
+++ b/api-ref/src/wadls/volume-api/src/v2/api_samples/volume_show_response.json
@@ -24,6 +24,8 @@
         "volume_type": "None",
         "os-vol-tenant-attr:tenant_id": "0c2eba2c5af04d3f9e9d0d410b371fde",
         "size": 1,
+        "os-volume-replication:driver_data": null,
+        "os-volume-replication:extended_status": null,
         "metadata": {
             "contents": "not junk"
         }
diff --git a/api-ref/src/wadls/volume-api/src/v2/common.ent b/api-ref/src/wadls/volume-api/src/v2/common.ent
index 536a77bdb..2e41f67a3 100644
--- a/api-ref/src/wadls/volume-api/src/v2/common.ent
+++ b/api-ref/src/wadls/volume-api/src/v2/common.ent
@@ -633,6 +633,22 @@
        xmlns:wadl="http://wadl.dev.java.net/2009/02"
        xml:lang="EN">
        <para>The size of the volume, in gibibytes (GiB).</para></wadl:doc>
+</param>
+<param xmlns="http://wadl.dev.java.net/2009/02"
+    name="os-volume-replication:driver_data" style="plain" type="xsd:string"
+    required="false">
+    <wadl:doc xmlns="http://docbook.org/ns/docbook"
+       xmlns:wadl="http://wadl.dev.java.net/2009/02"
+       xml:lang="EN">
+       <para>The name of the volume replication driver.</para></wadl:doc>
+</param>
+<param xmlns="http://wadl.dev.java.net/2009/02"
+     name="os-volume-replication:extended_status" style="plain" type="xsd:string"
+    required="false">
+    <wadl:doc xmlns="http://docbook.org/ns/docbook"
+       xmlns:wadl="http://wadl.dev.java.net/2009/02"
+       xml:lang="EN">
+       <para>The status of the volume replication.</para></wadl:doc>
 </param>' >
 <!ENTITY quotasResponse '
 <param name="quota_set" style="plain" required="true"
@@ -787,6 +803,28 @@
         </para>
     </wadl:doc>
 </param>'>
+<!ENTITY promotereplicaVolumeReqParameters '
+<param xmlns="http://wadl.dev.java.net/2009/02" name="os-promote-replica" style="plain"
+    type="xsd:dict" required="true">
+    <wadl:doc xmlns="http://docbook.org/ns/docbook"
+       xmlns:wadl="http://wadl.dev.java.net/2009/02"
+       xml:lang="EN">
+        <para>
+            The <code>os-promote-replica</code> action.
+        </para>
+    </wadl:doc>
+</param>'>
+<!ENTITY reenablereplicaVolumeReqParameters '
+<param xmlns="http://wadl.dev.java.net/2009/02" name="os-reenable-replica" style="plain"
+    type="xsd:dict" required="true">
+    <wadl:doc xmlns="http://docbook.org/ns/docbook"
+       xmlns:wadl="http://wadl.dev.java.net/2009/02"
+       xml:lang="EN">
+        <para>
+            The <code>os-reenable-replica</code> action.
+        </para>
+    </wadl:doc>
+</param>'>
 <!ENTITY backendParametersResponse '
 <param name="namespace" style="plain" required="true"
    xmlns="http://wadl.dev.java.net/2009/02"
diff --git a/api-ref/src/wadls/volume-api/src/v2/volume-api-v2.wadl b/api-ref/src/wadls/volume-api/src/v2/volume-api-v2.wadl
index 5607532ec..435608836 100644
--- a/api-ref/src/wadls/volume-api/src/v2/volume-api-v2.wadl
+++ b/api-ref/src/wadls/volume-api/src/v2/volume-api-v2.wadl
@@ -70,6 +70,8 @@
                             <method href="#attachVolume"/>
                             <method href="#unmanageVolume"/>
                             <method href="#forcedetachVolume"/>
+                            <method href="#promotereplicaVolume"/>
+                            <method href="#reenablereplicaVolume"/>
                         </resource>
                     </resource>
                 </resource>
@@ -103,9 +105,11 @@
                             required="true" type="csapi:UUID">
                             <wadl:doc
                                 xmlns="http://docbook.org/ns/docbook"
-                                xml:lang="EN"><para>The unique
-                                   identifier of an existing
-                                   snapshot.</para></wadl:doc>
+                                xml:lang="EN">
+                                <para>
+                                    The UUID of the snapshot.
+                               </para>
+                           </wadl:doc>
                         </param>
                         <method href="#getSnapshot"/>
                         <method href="#updateSnapshot"/>
@@ -500,7 +504,7 @@
     </method>
     <method name="POST" id="extendVolume">
         <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN"
-            title="Extend volume">
+            title="Extend volume size">
             <para role="shortdesc">
                 Extends the size of a volume to a requested size, in gibibytes
                 (GiB). Specify the <code>os-extend</code> action in the
@@ -755,6 +759,49 @@
         </request>
         <response status="202"/>
     </method>
+    <method name="POST" id="promotereplicaVolume">
+        <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN"
+            title="Promote replicated volume">
+            <para role="shortdesc">
+                Promotes a replicated volume. Specify the
+                <code>os-promote-replica</code> action in
+                the request body.
+            </para>
+        </wadl:doc>
+        <request>
+            <representation mediaType="application/json">
+                <wadl:doc xmlns="http://docbook.org/ns/docbook"
+                    xml:lang="EN">
+                    <xsdxt:code
+                        href="api_samples/os-replica/os-promote-replica-request.json"
+                    />
+                </wadl:doc>
+                &promotereplicaVolumeReqParameters;
+            </representation>
+        </request>
+        <response status="202"/>
+    </method>
+    <method name="POST" id="reenablereplicaVolume">
+        <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN"
+            title="Reenable volume replication">
+            <para role="shortdesc">
+                Re-enables replication of a volume. Specify the
+                <code>os-reenable-replica</code> action in the request body.
+            </para>
+        </wadl:doc>
+        <request>
+            <representation mediaType="application/json">
+                <wadl:doc xmlns="http://docbook.org/ns/docbook"
+                    xml:lang="EN">
+                    <xsdxt:code
+                        href="api_samples/os-replica/os-reenable-replica-request.json"
+                    />
+                </wadl:doc>
+                &reenablereplicaVolumeReqParameters;
+            </representation>
+        </request>
+        <response status="202"/>
+    </method>
     <method name="GET" id="getVolumeTypes">
         <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN"
             title="List volume types">
@@ -1072,7 +1119,7 @@
     </method>
     <method name="GET" id="getSnapshotsDetail">
         <wadl:doc xmlns="http://docbook.org/ns/docbook" xml:lang="EN"
-            title="List snapshots (detailed)">
+            title="List snapshots with details">
             <para role="shortdesc">
                 Lists all Block Storage snapshots, with details, that the
                 tenant can access.