diff --git a/api-ref/source/containers.inc b/api-ref/source/containers.inc
index edc3d0e3e..a89e159c9 100644
--- a/api-ref/source/containers.inc
+++ b/api-ref/source/containers.inc
@@ -563,6 +563,44 @@ This request does not return anything in the response body.
 
   - X-Openstack-Request-Id: request_id
 
+Rebuild a container
+===================
+
+.. rest_method:: POST /v1/containers/{container_ident}/rebuild
+
+Rebuild a container.
+
+Response Codes
+--------------
+
+.. rest_status_code:: success status.yaml
+
+   - 202
+
+.. rest_status_code:: error status.yaml
+
+   - 401
+   - 403
+   - 404
+
+Request
+-------
+
+.. rest_parameters:: parameters.yaml
+
+   - container_ident: container_ident
+
+Response
+--------
+
+This request does not return anything in the response body.
+
+.. rest_parameters:: parameters.yaml
+
+   - X-Openstack-Request-Id: request_id
+
+
+
 Restart a container
 ===================