# 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:
    - Status code:
        + `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.