diff --git a/docs/openapi.json b/docs/openapi.json
index 4f437081..bb9498d0 100644
--- a/docs/openapi.json
+++ b/docs/openapi.json
@@ -1453,7 +1453,7 @@
         ],
         "responses": {
           "200": {
-            "description": "Requests succeeded. The file has been downloaded.",
+            "description": "Requests succeeded. Details about deleted files and failed deletions are returned.",
             "schema": {
               "type": "file"
             }
diff --git a/reana_workflow_controller/rest/workflows_workspace.py b/reana_workflow_controller/rest/workflows_workspace.py
index 7d8a961b..fd0d2034 100644
--- a/reana_workflow_controller/rest/workflows_workspace.py
+++ b/reana_workflow_controller/rest/workflows_workspace.py
@@ -315,7 +315,7 @@ def delete_file(workflow_id_or_name, file_name):  # noqa
       responses:
         200:
           description: >-
-            Requests succeeded. The file has been downloaded.
+            Requests succeeded. Details about deleted files and failed deletions are returned.
           schema:
             type: file
         404: