/materials/new|deleted

api/material.yaml

@@ -2,7 +2,30 @@
   get:
     summary: lists all materials
     description: 'Auth: all, levels: read, write, maintain, dev, admin'
-    x-doc: returns only materials with status 10  # TODO: methods /materials/new|deleted
+    x-doc: returns only materials with status 10
+    tags:
+      - /material
+    responses:
+      200:
+        description: all material details
+        content:
+          application/json:
+            schema:
+              type: array
+              items:
+                $ref: 'api.yaml#/components/schemas/Material'
+      401:
+        $ref: 'api.yaml#/components/responses/401'
+      500:
+        $ref: 'api.yaml#/components/responses/500'
+
+/materials/{group}:
+  parameters:
+    - $ref: 'api.yaml#/components/parameters/Group'
+  get:
+    summary: lists all new/deleted materials
+    description: 'Auth: basic, levels: maintain, admin'
+    x-doc: returns materials with status 0/-1
     tags:
       - /material
     responses:

api/parameters.yaml

@@ -5,10 +5,20 @@ Id:
   schema:
     type: string
   example: 5ea0450ed851c30a90e70894
+
 Name:
   name: name
   description: has to be URL encoded
   in: path
   required: true
   schema:
-    type: string
+    type: string
+
+Group:
+  name: group
+  description: 'possible values: new, deleted'
+  in: path
+  required: true
+  schema:
+    type: string
+  example: deleted