Feature: documents trash aka soft delete (#6944)

src/documents/serialisers.py

@@ -786,6 +786,7 @@ class DocumentSerializer(
             "created_date",
             "modified",
             "added",
+            "deleted_at",
             "archive_serial_number",
             "original_file_name",
             "archived_file_name",
@@ -1863,3 +1864,26 @@ class WorkflowSerializer(serializers.ModelSerializer):
         self.prune_triggers_and_actions()
 
         return instance
+
+
+class TrashSerializer(SerializerWithPerms):
+    documents = serializers.ListField(
+        required=False,
+        label="Documents",
+        write_only=True,
+        child=serializers.IntegerField(),
+    )
+
+    action = serializers.ChoiceField(
+        choices=["restore", "empty"],
+        label="Action",
+        write_only=True,
+    )
+
+    def validate_documents(self, documents):
+        count = Document.deleted_objects.filter(id__in=documents).count()
+        if not count == len(documents):
+            raise serializers.ValidationError(
+                "Some documents in the list have not yet been deleted.",
+            )
+        return documents