diff --git a/docs/swagger-ui/swagger.json b/docs/swagger-ui/swagger.json
index 9fefa92d..87de3614 100644
--- a/docs/swagger-ui/swagger.json
+++ b/docs/swagger-ui/swagger.json
@@ -620,7 +620,7 @@
           {
             "name": "metadata",
             "in": "formData",
-            "description": "Metadata for this file",
+            "description": "Metadata changes for this file. If used, the content type of this parameter (*not* of the request) needs to be set to *'application/json'*. E.g.: https://curl.se/docs/manpage.html#-F",
             "required": false,
             "type": "string"
           },
@@ -636,11 +636,14 @@
           "200": {
             "description": "Success",
             "schema": {
-              "$ref": "#/definitions/NodeInfo"
+              "$ref": "#/definitions/MetadataChanges"
             }
           },
           "403": {
             "description": "Not Authorized"
+          },
+          "415": {
+            "description": "Incorrect content type"
           }
         }
       }