Merge branch 'develop' of github.com:TheHive-Project/docs into develop

Author: jeromeleonard

docs/thehive/api/organisation/create.md

@@ -10,9 +10,9 @@ POST /api/v0/organisation
 
 ## Request
 
-### Request Body
+### Request Body Example
 
-!!! Example
+!!! Example ""
 
     ```json
     {
@@ -34,20 +34,41 @@ The following fields are required:
 
 - `201`: if organisation creation completed successfully
 - `401`: Authentication error
-
-### Response Body
-
-!!! Example
-
-    ```json
-    {
-        "_id": "~204804296",
-        "_type": "organisation",
-        "createdAt": 1630385478884,
-        "createdBy": "[email protected]",
-        "description": "SOC team",
-        "id": "~204804296",
-        "links": [],
-        "name": "soc"
-    }
-    ```
+- `403`: Authorization error
+
+### Response Body Example
+
+!!! Example ""
+
+    === "200"
+
+        ```json
+        {
+            "_id": "~204804296",
+            "_type": "organisation",
+            "createdAt": 1630385478884,
+            "createdBy": "[email protected]",
+            "description": "SOC team",
+            "id": "~204804296",
+            "links": [],
+            "name": "soc"
+        }
+        ```
+
+    === "401" 
+
+        ```json
+        {
+          "type": "AuthenticationError",
+          "message": "Authentication failure"
+        }
+        ```
+
+    === "403"
+
+        ```json
+        {
+            "type": "AuthorizationError",
+            "message": "Unauthorized action"
+        }
+        ```