diff --git a/api-ref/source/containers.inc b/api-ref/source/containers.inc
index 55d59497a..e63aac43a 100644
--- a/api-ref/source/containers.inc
+++ b/api-ref/source/containers.inc
@@ -58,6 +58,7 @@ Request
   - availability_zone: container_availability_zone
   - hints: hints
   - mounts: mounts
+  - privileged: privileged-request
 
 Request Example
 ----------------
@@ -95,6 +96,7 @@ Response
   - ports: ports
   - auto_remove: auto_remove
   - auto_heal: auto_heal
+  - privileged: privileged
 
 
 Response Example
@@ -166,6 +168,7 @@ Response
   - task_state: task_state
   - status_reason: status_reason
   - ports: ports
+  - privileged: privileged
 
 Response Example
 ----------------
@@ -228,6 +231,7 @@ Response
   - task_state: task_state
   - status_reason: status_reason
   - ports: ports
+  - privileged: privileged
 
 Response Example
 ----------------
@@ -428,6 +432,7 @@ Return new container with updated attributes.
   - task_state: task_state
   - status_reason: status_reason
   - ports: ports
+  - privileged: privileged
 
 Response Example
 ----------------
diff --git a/api-ref/source/parameters.yaml b/api-ref/source/parameters.yaml
index 317e5c172..2d201691b 100644
--- a/api-ref/source/parameters.yaml
+++ b/api-ref/source/parameters.yaml
@@ -769,6 +769,18 @@ ports:
   in: body
   required: true
   type: string
+privileged:
+  description: |
+    Give extended privileges to the container.
+  in: body
+  required: true
+  type: boolean
+privileged-request:
+  description: |
+    Give extended privileges to the container.
+  in: body
+  required: false
+  type: boolean
 project_id_container_action:
   description: |
     The UUID of the project that this container belongs to.
diff --git a/api-ref/source/samples/container-create-req.json b/api-ref/source/samples/container-create-req.json
index 2bfe1ed2a..76b3a4c0e 100644
--- a/api-ref/source/samples/container-create-req.json
+++ b/api-ref/source/samples/container-create-req.json
@@ -42,5 +42,6 @@
             "source": "myvol",
             "destination": "/data"
         }
-    ]
+    ],
+    "privileged": false
 }
diff --git a/api-ref/source/samples/container-create-resp.json b/api-ref/source/samples/container-create-resp.json
index 11a425d1b..b3770c0d8 100644
--- a/api-ref/source/samples/container-create-resp.json
+++ b/api-ref/source/samples/container-create-resp.json
@@ -39,6 +39,7 @@
     "hostname": "testhost",
     "auto_remove": false,
     "auto_heal": false,
+    "privileged": false,
     "disk": 0,
     "user_id": "0a9cdb65757b4216935e27f333d1c48b",
     "project_id": "77a89a275765486d86144caad70825e4"
diff --git a/api-ref/source/samples/container-get-all-resp.json b/api-ref/source/samples/container-get-all-resp.json
index 27e449e24..7cfa51143 100644
--- a/api-ref/source/samples/container-get-all-resp.json
+++ b/api-ref/source/samples/container-get-all-resp.json
@@ -42,6 +42,7 @@
             "status_detail": "Exited(0) 10 mins ago ",
             "auto_remove": false,
             "auto_heal": false,
+            "privileged": false,
             "host": "ubuntu",
             "image_driver": "docker",
             "task_state": null,
diff --git a/api-ref/source/samples/container-show-resp.json b/api-ref/source/samples/container-show-resp.json
index 575328b8b..f1b551512 100644
--- a/api-ref/source/samples/container-show-resp.json
+++ b/api-ref/source/samples/container-show-resp.json
@@ -39,6 +39,7 @@
     "workdir": "/home/ubuntu",
     "auto_remove": false,
     "auto_heal": false,
+    "privileged": false,
     "status_detail": "Exited(0) 8 mins ago ",
     "host": "ubuntu",
     "image_driver": "docker",
diff --git a/api-ref/source/samples/container-update-resp.json b/api-ref/source/samples/container-update-resp.json
index 7218de91c..371a657f3 100644
--- a/api-ref/source/samples/container-update-resp.json
+++ b/api-ref/source/samples/container-update-resp.json
@@ -49,5 +49,6 @@
     "command": "/bin/sh -c 'echo hello'",
     "runtime": "runc",
     "cpu": 3.0,
-    "interactive": false
+    "interactive": false,
+    "privileged": false,
 }