From dc9e9c11819e1b600742074658ee548e4eea29ea Mon Sep 17 00:00:00 2001
From: Marco Realacci <marco@marcorealacci.me>
Date: Wed, 23 Nov 2022 11:19:38 +0100
Subject: [PATCH] PUTs now return 201

---
 doc/api.yaml | 30 ++++++++++++++++++++++++++----
 1 file changed, 26 insertions(+), 4 deletions(-)

diff --git a/doc/api.yaml b/doc/api.yaml
index f0b723b..60c9738 100644
--- a/doc/api.yaml
+++ b/doc/api.yaml
@@ -258,8 +258,16 @@ paths:
       security:
         - BearerAuth: []
       responses:
-        '204':
+        '201':
           description: Ban user action successful.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/generic_response"
+              example:
+                status: "Success"
+        '204':
+          description: The user is already banned.
         '403':
           description: The user has no permission to perform this action.
           content:
@@ -391,8 +399,16 @@ paths:
       security:
         - BearerAuth: []
       responses:
-        '204':
+        '201':
           description: Like photo action successful.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/generic_response"
+              example:
+                status: "Success"
+        '204':
+          description: The user already likes the photo.
         '403':
           description: The user has no permission to perform this action.
           content:
@@ -768,8 +784,14 @@ paths:
             example:
               comment: "Lovely!"
       responses:
-        '204':
-          description: Comment photo action successful. #todo maybe 201
+        '201':
+          description: Comment photo action successful.
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/generic_response"
+              example:
+                status: "Created"
         '404':
           description: The user or the photo does not exists (or the author of the photo has banned the authorized user).
           content: