diff --git a/api-ref/source/v3/attachments.inc b/api-ref/source/v3/attachments.inc
index bcc5dd4c5f9..6adacf1c2e1 100644
--- a/api-ref/source/v3/attachments.inc
+++ b/api-ref/source/v3/attachments.inc
@@ -251,3 +251,29 @@ Response Example
 
 .. literalinclude:: ./samples/attachment-update-response.json
    :language: javascript
+
+
+Complete attachment
+~~~~~~~~~~~~~~~~~~~
+
+.. rest_method::  POST /v3/{project_id}/attachments/{attachment_id}/action
+
+Complete an attachment for a cinder volume.
+
+Normal response codes: 202
+Error response codes: badRequest(400), itemNotFound(404)
+
+
+Request
+-------
+
+.. rest_parameters:: parameters.yaml
+
+   - project_id: project_id_path
+   - attachment_id: attachment_id_1
+
+Request Example
+---------------
+
+.. literalinclude:: ./samples/attachment-complete.json
+   :language: javascript
diff --git a/api-ref/source/v3/samples/attachment-complete.json b/api-ref/source/v3/samples/attachment-complete.json
new file mode 100644
index 00000000000..35340169164
--- /dev/null
+++ b/api-ref/source/v3/samples/attachment-complete.json
@@ -0,0 +1,4 @@
+{
+    "os-complete": {
+    }
+}