Add documentation for the settings api

Signed-off-by: Joas Schilling <coding@schilljs.com>

docs/settings.md

@@ -0,0 +1,26 @@
+# Settings API
+
+* Base endpoint: `/ocs/v2.php/apps/spreed/api/v1`
+
+## Set user´s settings
+
+* Method: `POST`
+* Endpoint: `/settings/user`
+* Data:
+
+    field | type | Description
+    ------|------|------------
+    `key` | string | The user config to set
+    `value` | string | The value to set
+
+* Response:
+    - Header:
+        + `200 OK` When the value was updated
+        + `400 Bad Request` When the key or value was invalid
+        + `401 Unauthorized` When the user is not logged in
+
+## User settings
+
+Key | Capability | Default | Valid values
+----|------------|---------|-------------
+`attachment_folder` | `config => attachments => folder` | `/Talk` | Path owned by the user to store uploads and received shares. It is created if it does not exist.

mkdocs.yml

@@ -25,6 +25,7 @@ nav:
       - 'Call management': 'call.md'
       - 'Chat management': 'chat.md'
       - 'Webinar management': 'webinar.md'
+      - 'Settings': 'settings.md'
       - 'Integration by other apps': 'integration.md'
       - 'Internal signaling API': 'internal-signaling.md'
       - 'External signaling API': 'standalone-signaling-api-v1.md'