> For the complete documentation index, see [llms.txt](https://docs.ushahidi.com/v3-ushahidi-platform-rest-api-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.ushahidi.com/v3-ushahidi-platform-rest-api-documentation/v3/users/user-settings.md).

# User Settings

{% openapi src="/files/DFxnj85ZsASPYXzkPAko" path="/api/v3/users/2/settings" method="get" %}
[UshahidiV3.json](https://content.gitbook.com/content/tXIYKGMTeHub5C8O9fER/blobs/TC8KXqdBoVrA1ZGmo9Kk/UshahidiV3.json)
{% endopenapi %}

## add user settings

<mark style="color:green;">`POST`</mark> `https://ushahididocs.api.ushahidi.io/api/v3/users/5/settings`

#### Request Body

| Name          | Type   | Description             |
| ------------- | ------ | ----------------------- |
| config\_key   | String | The configuration key   |
| config\_value | String | The configuration value |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "id": 1,
    "url": "http://localhost:8000/api/v3/user_settings/1",
    "user": {
        "id": 2,
        "url": "http://localhost:8000/api/v3/users/2"
    },
    "config_key": "api some key222",
    "config_value": "******alue",
    "created": "2030-01-01T06:00:00+00:00",
    "updated": "2022-10-12T18:09:31+00:00",
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
    ]
}{
    "id": 1,
    "url": "http://localhost:8000/api/v3/user_settings/1",
    "user": {
        "id": 2,
        "url": "http://localhost:8000/api/v3/users/2"
    },
    "config_key": "api some key222",
    "config_value": "******alue",
    "created": "2030-01-01T06:00:00+00:00",
    "updated": "2022-10-12T18:09:31+00:00",
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
    ]
}
```

{% endtab %}
{% endtabs %}

## edit user settings

<mark style="color:orange;">`PUT`</mark> `https://ushahididocs.api.ushahidi.io/api/v3/users/2/settings/6`

#### Request Body

| Name          | Type   | Description             |
| ------------- | ------ | ----------------------- |
| config\_key   | String | The configuration key   |
| config\_value | String | The configuration value |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "id": 1,
    "url": "http://localhost:8000/api/v3/user_settings/1",
    "user": {
        "id": 2,
        "url": "http://localhost:8000/api/v3/users/2"
    },
    "config_key": "api some key222",
    "config_value": "******alue",
    "created": "2030-01-01T06:00:00+00:00",
    "updated": "2022-10-12T18:09:31+00:00",
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
    ]
}{
    "id": 1,
    "url": "http://localhost:8000/api/v3/user_settings/1",
    "user": {
        "id": 2,
        "url": "http://localhost:8000/api/v3/users/2"
    },
    "config_key": "api some key222",
    "config_value": "******alue",
    "created": "2030-01-01T06:00:00+00:00",
    "updated": "2022-10-12T18:09:31+00:00",
    "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
    ]
}
```

{% endtab %}
{% endtabs %}

{% openapi src="/files/DFxnj85ZsASPYXzkPAko" path="/api/v3/users/1/settings/40" method="delete" %}
[UshahidiV3.json](https://content.gitbook.com/content/tXIYKGMTeHub5C8O9fER/blobs/TC8KXqdBoVrA1ZGmo9Kk/UshahidiV3.json)
{% endopenapi %}