From eb776426049e540a58ed3b9fa180b39106081acc Mon Sep 17 00:00:00 2001
From: David Mehren <git@herrmehren.de>
Date: Sat, 17 Oct 2020 20:55:40 +0200
Subject: [PATCH] Public API: Update `/media/upload` route with supported
 content-types

Signed-off-by: David Mehren <git@herrmehren.de>
---
 docs/dev/public_api.yml | 65 +++++++++++++++++++++++++++++++++++++----
 1 file changed, 60 insertions(+), 5 deletions(-)

diff --git a/docs/dev/public_api.yml b/docs/dev/public_api.yml
index 181b80a10..be897596f 100644
--- a/docs/dev/public_api.yml
+++ b/docs/dev/public_api.yml
@@ -458,19 +458,74 @@ paths:
     post:
       tags:
         - media
-      summary: Uploads an image to the backend storage
-      description: Uploads an image to be processed by the backend.
+      summary: Uploads a media file to the backend storage
+      description: Uploads a file to be processed by the backend.
       requestBody:
         required: true
-        description: The binary image to upload.
+        description: The binary file to upload.
         content:
-          image/*:
+          application/pdf:
             schema:
               type: string
               format: binary
+          image/apng:
+            schema:
+              type: string
+              format: binary
+          image/bmp:
+            schema:
+              type: string
+              format: binary
+          image/gif:
+            schema:
+              type: string
+              format: binary
+          image/heif:
+            schema:
+              type: string
+              format: binary
+          image/heic:
+            schema:
+              type: string
+              format: binary
+          image/heif-sequence:
+            schema:
+              type: string
+              format: binary
+          image/heic-sequence:
+            schema:
+              type: string
+              format: binary
+          image/jpeg:
+            schema:
+              type: string
+              format: binary
+          image/png:
+            schema:
+              type: string
+              format: binary
+          image/svg+xml:
+            schema:
+              type: string
+              format: binary
+          image/tiff:
+            schema:
+              type: string
+              format: binary
+          image/webp:
+            schema:
+              type: string
+              format: binary
+      parameters:
+        - in: header
+          name: HedgeDoc-Note
+          schema:
+            type: string
+          required: true
+          description: ID or alias of the parent note
       responses:
         '200':
-          description: The image was uploaded successfully.
+          description: The file was uploaded successfully.
           content:
             application/json:
               schema: