diff --git a/docs/api.md b/docs/api.md
index 3a648c3e9..1b00706da 100644
--- a/docs/api.md
+++ b/docs/api.md
@@ -315,13 +315,13 @@ The following methods are supported:
             -   `"doc": OUTPUT_DOCUMENT_INDEX` Optional index of the output document for split operations.
     -   Optional `parameters`:
         -   `"delete_original": true` to delete the original documents after editing.
-        -   `"update_document": true` to update the existing document with the edited PDF.
+        -   `"update_document": true` to add the edited PDF as a new version of the selected/root document.
         -   `"include_metadata": true` to copy metadata from the original document to the edited document.
 -   `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.
+        -   `"update_document": true` to add the password-less PDF as a new version of the selected/root document.
         -   `"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`
diff --git a/src/documents/views.py b/src/documents/views.py
index 2274ea5b4..b83a4b065 100644
--- a/src/documents/views.py
+++ b/src/documents/views.py
@@ -2017,6 +2017,8 @@ class BulkEditView(PassUserMixin):
         "modify_custom_fields": "custom_fields",
         "set_permissions": None,
         "delete": "deleted_at",
+        # These operations create new documents/versions no longer altering
+        # fields on the selected document in place
         "rotate": None,
         "delete_pages": None,
         "split": None,