User Settings

get user settings

get

Authorizations

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/users/2/settings' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

200

{
  "count": 1,
  "results": [
    {
      "id": 1,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/user_settings/1",
      "user": {
        "id": 2,
        "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/2"
      },
      "config_key": "api some key",
      "config_value": "******alue",
      "created": "2030-01-01T06:00:00.000Z",
      "updated": "2030-01-01T06:00:00.000Z",
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ]
    }
  ],
  "offset": 0,
  "order": "asc",
  "orderby": "id",
  "curr": "https://ushahididocs.api.ushahidi.io//api/v3/users/2/settings?orderby=id&order=asc&offset=0",
  "next": "https://ushahididocs.api.ushahidi.io//api/v3/users/2/settings?orderby=id&order=asc&offset=0",
  "prev": "https://ushahididocs.api.ushahidi.io//api/v3/users/2/settings?orderby=id&order=asc&offset=0",
  "total_count": 1
}

OK

add user settings

POST 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

200: OK

{
    "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"
    ]
}

edit user settings

PUT 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

200: OK

{
    "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"
    ]
}

delete user settings

delete

Authorizations

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url 'https://ushahididocs.api.ushahidi.io/api/v3/users/1/settings/40' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

200

404

200

{
  "id": 4,
  "url": "https://ushahididocs.api.ushahidi.io//api/v3/user_settings/4",
  "user": {
    "id": 2,
    "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/2"
  },
  "config_key": "api some key2",
  "config_value": "******alue",
  "created": "2030-01-01T06:00:00.000Z",
  "updated": "2030-01-01T06:00:00.000Z",
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search",
    "read_full",
    "register"
  ]
}

OK