diff --git a/docs/shared_ips.raml b/docs/shared_ips.raml
index 4bee956..01861ef 100644
--- a/docs/shared_ips.raml
+++ b/docs/shared_ips.raml
@@ -67,9 +67,9 @@ traits:
                                     "address": "192.168.10.1",
                                     "port_ids": ["6200d533-a42b-4c04-82a1-cc14dbdbf2de"],
                                     "subnet_id": "f11687e8-ef0d-4207-8e22-c60e737e473b",
-                                    "used_by_tenant_id": "2345678",
+                                    "tenant_id": "2345678",
                                     "version": "4",
-                                    "address_type": "fixed"}
+                                    "type": "fixed"}
                             }
             400:
                 description: |
@@ -102,9 +102,9 @@ traits:
                                     "address": "192.168.10.1",
                                     "port_ids": ['2f693cca-7383-45da-8bae-d26b6c2d6718'],
                                     "subnet_id": "f11687e8-ef0d-4207-8e22-c60e737e473b",
-                                    "used_by_tenant_id": "2345678",
+                                    "tenant_id": "2345678",
                                     "version": "4",
-                                    "address_type": "fixed"}
+                                    "type": "fixed"}
                 404:
                     description: not found, e.g. another tenant's IP address
         put: