diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index e4aba618d81..bb201bc2e85 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -806,10 +806,11 @@ addFixedIp:
   type: string
 addFloatingIp:
   description: |
-    The action.
+    The action. Contains required floating IP ``address`` and optional
+    ``fixed_address``.
   in: body
   required: true
-  type: string
+  type: object
 address:
   description: |
     The floating IP address.
diff --git a/api-ref/source/servers-actions.inc b/api-ref/source/servers-actions.inc
index 588f4c972f9..e5db3bab02f 100644
--- a/api-ref/source/servers-actions.inc
+++ b/api-ref/source/servers-actions.inc
@@ -67,11 +67,10 @@ Request
   - address: address
   - fixed_address: fixed_address
 
-.. TODO(gmann) Need to create the sample file for this action.
-   **Example Add (Associate) Floating Ip (addFloatingIp Action): JSON request**
+**Example Add (Associate) Floating Ip (addFloatingIp Action): JSON request**
 
-   .. literalinclude:: ../../doc/api_samples/os-floating-ips/floating-ips-create-resp.json
-      :language: javascript
+.. literalinclude:: ../../doc/api_samples/servers/server-action-addfloatingip.json
+  :language: javascript
 
 Response
 --------