diff --git a/api-ref/source/v2/ports.inc b/api-ref/source/v2/ports.inc
index 8e23e19..38284e5 100644
--- a/api-ref/source/v2/ports.inc
+++ b/api-ref/source/v2/ports.inc
@@ -55,6 +55,7 @@ Response Parameters
    - created_at: created_at
    - security_groups: security_groups
    - device_id: device_id
+   - description: description
 
 Response Example
 ----------------
@@ -112,6 +113,7 @@ Request
    - security_groups: security_groups
    - device_id: device_id
    - port_id: port_id
+   - description: description-request
 
 Request Example
 ---------------
@@ -146,6 +148,7 @@ Response Parameters
    - created_at: created_at
    - security_groups: security_groups
    - device_id: device_id
+   - description: description
 
 Response Example
 ----------------
@@ -221,6 +224,7 @@ Response Parameters
    - created_at: created_at
    - security_groups: security_groups
    - device_id: device_id
+   - description: description
 
 Response Example
 ----------------
@@ -261,6 +265,7 @@ Request
    - port: port
    - security_groups: security_groups
    - device_id: device_id
+   - description: description-request
 
 Request Example
 ---------------
@@ -295,6 +300,13 @@ Response Parameters
    - created_at: created_at
    - security_groups: security_groups
    - device_id: device_id
+   - description: description
+
+Response Example
+----------------
+
+.. literalinclude:: samples/ports/port-create-response.json
+   :language: javascript
 
 Bulk create ports
 =================
@@ -328,6 +340,7 @@ Request
    - ports: ports
    - security_groups: security_groups
    - device_id: device_id
+   - description: description-request
 
 Request Example
 ---------------
@@ -362,4 +375,10 @@ Response Parameters
    - created_at: created_at
    - security_groups: security_groups
    - device_id: device_id
+   - description: description
 
+Response Example
+----------------
+
+.. literalinclude:: samples/ports/ports-bulk-create-response.json
+   :language: javascript
diff --git a/api-ref/source/v2/samples/ports/port-bind-create-update-response.json b/api-ref/source/v2/samples/ports/port-bind-create-update-response.json
index 2ddd038..7f4a444 100644
--- a/api-ref/source/v2/samples/ports/port-bind-create-update-response.json
+++ b/api-ref/source/v2/samples/ports/port-bind-create-update-response.json
@@ -24,6 +24,7 @@
         "security_groups": [
             "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
         ],
-        "device_id": ""
+        "device_id": "",
+        "description": ""
     }
 }
diff --git a/api-ref/source/v2/samples/ports/port-bind-show-response.json b/api-ref/source/v2/samples/ports/port-bind-show-response.json
index 97f9d97..2c8d4ce 100644
--- a/api-ref/source/v2/samples/ports/port-bind-show-response.json
+++ b/api-ref/source/v2/samples/ports/port-bind-show-response.json
@@ -27,6 +27,7 @@
         ],
         "id": "46d4bfb9-b26e-41f3-bd2e-e6dcc1ccedb2",
         "security_groups": [],
-        "device_id": "5e3898d7-11be-483e-9732-b2f5eccd2b2e"
+        "device_id": "5e3898d7-11be-483e-9732-b2f5eccd2b2e",
+        "description": ""
     }
 }
diff --git a/api-ref/source/v2/samples/ports/port-create-response.json b/api-ref/source/v2/samples/ports/port-create-response.json
index d5651cc..c2c4d4a 100644
--- a/api-ref/source/v2/samples/ports/port-create-response.json
+++ b/api-ref/source/v2/samples/ports/port-create-response.json
@@ -19,6 +19,7 @@
         "security_groups": [
             "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
         ],
-        "device_id": ""
+        "device_id": "",
+        "description": ""
     }
 }
diff --git a/api-ref/source/v2/samples/ports/port-show-response.json b/api-ref/source/v2/samples/ports/port-show-response.json
index 2eed2b2..b879427 100644
--- a/api-ref/source/v2/samples/ports/port-show-response.json
+++ b/api-ref/source/v2/samples/ports/port-show-response.json
@@ -20,6 +20,7 @@
         "id": "46d4bfb9-b26e-41f3-bd2e-e6dcc1ccedb2",
         "updated_at": "2016-03-08T20:19:41",
         "security_groups": [],
-        "device_id": "5e3898d7-11be-483e-9732-b2f5eccd2b2e"
+        "device_id": "5e3898d7-11be-483e-9732-b2f5eccd2b2e",
+        "description": ""
     }
 }
diff --git a/api-ref/source/v2/samples/ports/port-update-response.json b/api-ref/source/v2/samples/ports/port-update-response.json
index b09820d..5cd31f5 100644
--- a/api-ref/source/v2/samples/ports/port-update-response.json
+++ b/api-ref/source/v2/samples/ports/port-update-response.json
@@ -25,6 +25,7 @@
         "binding:vif_details": {},
         "binding:vnic_type": "normal",
         "binding:vif_type": "binding_failed",
-        "mac_address": "fa:16:3e:11:11:5e"
+        "mac_address": "fa:16:3e:11:11:5e",
+        "description": ""
     }
 }
diff --git a/api-ref/source/v2/samples/ports/ports-bind-show-response.json b/api-ref/source/v2/samples/ports/ports-bind-show-response.json
index 8139f9e..b978c5c 100644
--- a/api-ref/source/v2/samples/ports/ports-bind-show-response.json
+++ b/api-ref/source/v2/samples/ports/ports-bind-show-response.json
@@ -28,7 +28,8 @@
             ],
             "id": "d80b1a3b-4fc1-49f3-952e-1e2ab7081d8b",
             "security_groups": [],
-            "device_id": "9ae135f4-b6e0-4dad-9e91-3c223e385824"
+            "device_id": "9ae135f4-b6e0-4dad-9e91-3c223e385824",
+            "description": ""
         },
         {
             "status": "ACTIVE",
@@ -58,7 +59,8 @@
             ],
             "id": "f71a6703-d6de-4be1-a91a-a570ede1d159",
             "security_groups": [],
-            "device_id": "9ae135f4-b6e0-4dad-9e91-3c223e385824"
+            "device_id": "9ae135f4-b6e0-4dad-9e91-3c223e385824",
+            "description": ""
         }
     ]
 }
diff --git a/api-ref/source/v2/samples/ports/ports-bulk-create-response.json b/api-ref/source/v2/samples/ports/ports-bulk-create-response.json
index daefc13..39d9978 100644
--- a/api-ref/source/v2/samples/ports/ports-bulk-create-response.json
+++ b/api-ref/source/v2/samples/ports/ports-bulk-create-response.json
@@ -20,7 +20,8 @@
             "security_groups": [
                 "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
             ],
-            "device_id": ""
+            "device_id": "",
+            "description": ""
         },
         {
             "status": "DOWN",
@@ -42,7 +43,8 @@
             "security_groups": [
                 "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
             ],
-            "device_id": ""
+            "device_id": "",
+            "description": ""
         }
     ]
 }
diff --git a/api-ref/source/v2/samples/ports/ports-list-response.json b/api-ref/source/v2/samples/ports/ports-list-response.json
index 0ac5453..ee10fe9 100644
--- a/api-ref/source/v2/samples/ports/ports-list-response.json
+++ b/api-ref/source/v2/samples/ports/ports-list-response.json
@@ -19,7 +19,8 @@
             ],
             "id": "d80b1a3b-4fc1-49f3-952e-1e2ab7081d8b",
             "security_groups": [],
-            "device_id": "9ae135f4-b6e0-4dad-9e91-3c223e385824"
+            "device_id": "9ae135f4-b6e0-4dad-9e91-3c223e385824",
+            "description": ""
         },
         {
             "status": "ACTIVE",
@@ -40,7 +41,8 @@
             ],
             "id": "f71a6703-d6de-4be1-a91a-a570ede1d159",
             "security_groups": [],
-            "device_id": "9ae135f4-b6e0-4dad-9e91-3c223e385824"
+            "device_id": "9ae135f4-b6e0-4dad-9e91-3c223e385824",
+            "description": ""
         }
     ]
 }