diff --git a/api-ref/source/os-cloudpipe.inc b/api-ref/source/os-cloudpipe.inc
index 675087f4eae9..2b102acea188 100644
--- a/api-ref/source/os-cloudpipe.inc
+++ b/api-ref/source/os-cloudpipe.inc
@@ -1,11 +1,14 @@
 .. -*- rst -*-
-.. needs:parameter_verification
-.. needs:example_verification
-.. needs:body_verification
 
-==========================
- Cloudpipe (os-cloudpipe)
-==========================
+======================================
+ Cloudpipe (os-cloudpipe) (DEPRECATED)
+======================================
+
+.. warning::
+
+   This API only works with ``nova-network`` which is
+   deprecated in favor of Neutron. It should be avoided
+   in any new applications.
 
 Manages virtual VPNs for projects.
 
@@ -23,6 +26,17 @@ Error response codes: badRequest(400), unauthorized(401), forbidden(403), itemNo
 Response
 --------
 
+.. rest_parameters:: parameters.yaml
+
+  - cloudpipes: cloudpipes
+  - created_at: created
+  - instance_id: instance_id_cloudpipe
+  - internal_ip: fixed_ip
+  - project_id: project_id_instance_action
+  - public_ip: vpn_public_ip_resp
+  - public_port: vpn_public_port_resp
+  - state: vpn_state
+
 **Example List Cloudpipes: JSON response**
 
 .. literalinclude:: ../../doc/api_samples/os-cloudpipe/cloud-pipe-get-resp.json
@@ -44,6 +58,7 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
+  - cloudpipe: cloudpipe
   - project_id: project_id
 
 **Example Create Cloudpipe: JSON request**
@@ -54,6 +69,10 @@ Request
 Response
 --------
 
+.. rest_parameters:: parameters.yaml
+
+  - instance_id: instance_id_cloudpipe
+
 **Example Create Cloudpipe: JSON response**
 
 .. literalinclude:: ../../doc/api_samples/os-cloudpipe/cloud-pipe-create-resp.json
@@ -62,7 +81,7 @@ Response
 Update Cloudpipe
 ================
 
-.. rest_method:: POST /os-cloudpipe/configure-project
+.. rest_method:: PUT /os-cloudpipe/configure-project
 
 Updates the virtual private network (VPN) IP address and port for a cloudpipe instance.
 
@@ -75,8 +94,9 @@ Request
 
 .. rest_parameters:: parameters.yaml
 
-  - vpn_ip: vpn_ip
-  - vpn_port: vpn_port
+  - configure_project: configure_project_cloudpipe
+  - vpn_ip: vpn_public_ip
+  - vpn_port: vpn_public_port
 
 **Example Update Cloudpipe: JSON request**
 
@@ -85,3 +105,5 @@ Request
 
 Response
 --------
+
+There is no body content for the response of a successful PUT request
\ No newline at end of file
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 292e0c65cc87..20c34342e6f8 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -1201,6 +1201,18 @@ cidr:
   in: body
   required: true
   type: string
+cloudpipe:
+  description: |
+    The cloudpipe object.
+  in: body
+  required: true
+  type: object
+cloudpipes:
+  description: |
+    The list of cloudpipe objects.
+  in: body
+  required: true
+  type: array
 code:
   description: |
     The HTTP response code for the event. The following codes are currently used:
@@ -1229,6 +1241,12 @@ config_drive_resp:
   in: body
   required: true
   type: boolean
+configure_project_cloudpipe:
+  description: |
+    VPN IP and Port information to configure the cloudpipe instance..
+  in: body
+  required: true
+  type: object
 confirmResize:
   description: |
     The action.
@@ -2489,6 +2507,12 @@ instance_id_body:
   in: body
   required: true
   type: string
+instance_id_cloudpipe:
+  description: |
+    The UUID of the cloudpipe instance.
+  in: body
+  required: true
+  type: string
 instance_name:
   description: |
     The name of the instance.
@@ -4483,15 +4507,33 @@ volumes:
   in: body
   required: true
   type: array
-vpn_ip:
+vpn_public_ip:
   description: |
     The VPN IP address.
   in: body
   required: true
   type: string
-vpn_port:
+vpn_public_ip_resp:
+  description: |
+    The VPN public IP address.
+  in: body
+  required: false
+  type: string
+vpn_public_port:
   description: |
     The VPN port.
   in: body
   required: true
   type: string
+vpn_public_port_resp:
+  description: |
+    The VPN public port.
+  in: body
+  required: false
+  type: string
+vpn_state:
+  description: |
+    The VPN state.
+  in: body
+  required: false
+  type: string