diff --git a/docs/api.md b/docs/api.md
index 4e4941ca3..1ac634162 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -297,6 +297,10 @@ The following methods are supported:
 -   `remove_password`
     -   Requires `parameters`:
         -   `"password": "PASSWORD_STRING"` The password to remove from the PDF documents.
+    -   Optional `parameters`:
+        -   `"update_document": true` to replace the existing document with the password-less PDF.
+        -   `"delete_original": true` to delete the original document after editing.
+        -   `"include_metadata": true` to copy metadata from the original document to the new password-less document.
 -   `merge`
     -   No additional `parameters` required.
     -   The ordering of the merged document is determined by the list of IDs.