notification: update comment and api endpoint for marking as read/unread

src/Bundle/ChillMainBundle/chill.api.specs.yaml

@@ -733,4 +733,43 @@ paths:
                                     class: 'Chill\PersonBundle\Entity\AccompanyingPeriod'
                                     roles:
                                         - 'CHILL_PERSON_ACCOMPANYING_PERIOD_SEE'
+    /1.0/main/notification/{id}/mark/read:
+        post:
+            tags:
+                - notification
+            summary: mark a notification as read
+            parameters:
+                -   name: id
+                    in: path
+                    required: true
+                    description: The notification id
+                    schema:
+                        type: integer
+                        format: integer
+                        minimum: 1
+            responses:
+                202:
+                    description: "accepted"
+                403:
+                    description: "unauthorized"
+    /1.0/main/notification/{id}/mark/unread:
+        post:
+            tags:
+                - notification
+            summary: mark a notification as unread
+            parameters:
+                -   name: id
+                    in: path
+                    required: true
+                    description: The notification id
+                    schema:
+                        type: integer
+                        format: integer
+                        minimum: 1
+            responses:
+                202:
+                    description: "accepted"
+                403:
+                    description: "unauthorized"
+