Users

get users

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

orderbystringOptional

Sorting parameter Available values : entity fields Default value : id

orderstringOptional

Sorting parameter Available values : [ASC,DESC] Default value : ASC

limitinteger · int32Optional

Paging parameter Default value : null

offsetinteger · int32Optional

Paging parameter Default value : 0

qstringOptional

Filter parameter if this parameter is set then the api will return posts containing q text in name property

rolestringOptional

Filter parameter to return the users who have the role/roles. ItAccepts multiple values as an array or as a string but they will be separated by a comma

Responses

200

OK

application/json

countintegerOptional

limitintegerOptional

offsetintegerOptional

orderstringOptional

orderbystringOptional

currstringOptional

nextstringOptional

prevstringOptional

total_countintegerOptional

401

Unauthorized

application/json

get

/api/v3/users

HTTPcURLJavaScriptPython

GET /api/v3/users HTTP/1.1
Host: ushahididocs.api.ushahidi.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "count": 11,
  "results": [
    {
      "id": 1,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/1",
      "email": "[email protected]",
      "realname": "Test User",
      "logins": 1,
      "failed_attempts": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "updated": "2022-10-12T17:43:01.000Z",
      "role": "user",
      "contacts": [
        {
          "id": "1",
          "user_id": "1",
          "type": "phone",
          "contact": "123456789",
          "created": "0",
          "can_notify": "0"
        },
        {
          "id": "4",
          "user_id": "1",
          "type": "email",
          "contact": "[email protected]",
          "created": "0",
          "can_notify": "0"
        }
      ],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "1bef20a68c42ddc2f7d56a91d743cbe4"
    },
    {
      "id": 2,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/2",
      "email": "[email protected]",
      "realname": "Test User",
      "logins": 1,
      "failed_attempts": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "updated": "2022-10-12T17:48:09.000Z",
      "role": "admin",
      "contacts": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "3578216d69634e299351bb18b7c7fc46"
    },
    {
      "id": 3,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/3",
      "email": "[email protected]",
      "realname": "Test User",
      "logins": 0,
      "failed_attempts": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "role": "user",
      "contacts": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "982d5f5e2b53f4843ca1fe521025b342"
    },
    {
      "id": 4,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/4",
      "email": "[email protected]",
      "realname": "Import admin",
      "logins": 0,
      "failed_attempts": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "role": "admin",
      "contacts": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "c667c46b2d69005b456f0bbff0935297"
    },
    {
      "id": 5,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/5",
      "email": "[email protected]",
      "realname": "Demo",
      "logins": 0,
      "failed_attempts": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "role": "admin",
      "contacts": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "6e5562e5ac73cdff1c2c8b3b341fddf7"
    },
    {
      "id": 6,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/6",
      "email": "[email protected]",
      "realname": "Manager",
      "logins": 0,
      "failed_attempts": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "role": "manager",
      "contacts": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "48ee41c3fcea33d677c75aefca9293fc"
    },
    {
      "id": 7,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/7",
      "email": "[email protected]",
      "realname": "Importer",
      "logins": 0,
      "failed_attempts": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "contacts": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "6becb41fec259d4206e32b038439df3f"
    },
    {
      "id": 9,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/9",
      "email": "[email protected]",
      "realname": "Sets",
      "logins": 0,
      "failed_attempts": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "role": "sets",
      "contacts": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "324509b8efe1d480fc094010fb577019"
    },
    {
      "id": 10,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/10",
      "email": "[email protected]",
      "realname": "Settings Manager",
      "logins": 0,
      "failed_attempts": 0,
      "created": "1970-01-01T00:00:00.000Z",
      "role": "settingsmanager",
      "contacts": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "739096134b0557256853dfdf87295aa3"
    },
    {
      "id": 11,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/11",
      "email": "[email protected]",
      "realname": "Test User",
      "logins": 0,
      "failed_attempts": 0,
      "created": "2022-10-12T17:37:42.000Z",
      "role": "user",
      "contacts": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "efcce0e9872c8640a361cab9e2ede9a2"
    },
    {
      "id": 12,
      "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/12",
      "email": "[email protected]",
      "realname": "Test User",
      "logins": 1,
      "failed_attempts": 0,
      "created": "2022-10-12T17:39:11.000Z",
      "role": "user",
      "contacts": [],
      "allowed_privileges": [
        "read",
        "create",
        "update",
        "delete",
        "search",
        "read_full",
        "register"
      ],
      "gravatar": "df2b78c283eab681750183e449acc6bf"
    }
  ],
  "offset": 0,
  "order": "asc",
  "orderby": "id",
  "curr": "https://ushahididocs.api.ushahidi.io//api/v3/users?orderby=id&order=asc&offset=0",
  "next": "https://ushahididocs.api.ushahidi.io//api/v3/users?orderby=id&order=asc&offset=0",
  "prev": "https://ushahididocs.api.ushahidi.io//api/v3/users?orderby=id&order=asc&offset=0",
  "total_count": 11
}

add user

POST https://ushahididocs.api.ushahidi.io/api/v3/users

Request Body

Name	Type	Description
email	String	The user's email address
failed_attempts	Integer	Number of failed attempts
logins	integer	Number of login attempts
realname	String	The user's real name
password	String	The user's password
last_attempt	String	Date of previous login attempt
last_login	String	Last login date
gravatar	String	The user's gravatar
role	String	user's roleString

200: OK

{
  "id": 0,
  "url": "string",
  "email": "string",
  "realname": "string",
  "logins": 0,
  "failed_attempts": 0,
  "last_login": "string",
  "last_attempt": "string",
  "created": "string",
  "updated": "string",
  "role": "string",
  "language": "string",
  "contacts": [
    {
      "id": "string",
      "user_id": "string",
      "data_source": "string",
      "type": "string",
      "contact": "string",
      "created": "string",
      "updated": "string",
      "can_notify": "string"
    }
  ],
  "allowed_privileges": [
    "string"
  ],
  "gravatar": "string"
}

get user

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

idintegerOptional

urlstringOptional

emailstringOptional

realnamestringOptional

loginsintegerOptional

failed_attemptsintegerOptional

last_loginstringOptional

last_attemptstringOptional

createdstringOptional

updatedstringOptional

rolestringOptional

languagestringOptional

allowed_privilegesstring[]Optional

gravatarstringOptional

401

Unauthorized

application/json

404

Not Found

application/json

get

/api/v3/users/3

HTTPcURLJavaScriptPython

GET /api/v3/users/3 HTTP/1.1
Host: ushahididocs.api.ushahidi.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 3,
  "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/3",
  "email": "[email protected]",
  "realname": "Test User",
  "logins": 0,
  "failed_attempts": 0,
  "created": "1970-01-01T00:00:00.000Z",
  "role": "user",
  "contacts": [],
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search",
    "read_full",
    "register"
  ],
  "gravatar": "982d5f5e2b53f4843ca1fe521025b342"
}

edit user

PUT https://ushahididocs.api.ushahidi.io/api/v3/users/1

Request Body

Name	Type	Description
email	String	The user's email address
failed_attempts	Integer	Number of failed attempts
logins	integer	Number of login attempts
realname	String	The user's real name
password	String	The user's password
last_attempt	String	Date of previous login attempt
last_login	String	Last login date
gravatar	String	The user's gravatar
role	String	user's roleString

200: OK

{
  "id": 0,
  "url": "string",
  "email": "string",
  "realname": "string",
  "logins": 0,
  "failed_attempts": 0,
  "last_login": "string",
  "last_attempt": "string",
  "created": "string",
  "updated": "string",
  "role": "string",
  "language": "string",
  "contacts": [
    {
      "id": "string",
      "user_id": "string",
      "data_source": "string",
      "type": "string",
      "contact": "string",
      "created": "string",
      "updated": "string",
      "can_notify": "string"
    }
  ],
  "allowed_privileges": [
    "string"
  ],
  "gravatar": "string"
}

edit admin user

PUT https://ushahididocs.api.ushahidi.io/api/v3/users/me

Request Body

Name	Type	Description
email	String	The user's email address
failed_attempts	Integer	Number of failed attempts
logins	integer	Number of login attempts
realname	String	The user's real name
password	String	The user's password
last_attempt	String	Date of previous login attempt
last_login	String	Last login date
gravatar	String	The user's gravatar
role	String	user's roleString

200: OK

{
  "id": 0,
  "url": "string",
  "email": "string",
  "realname": "string",
  "logins": 0,
  "failed_attempts": 0,
  "last_login": "string",
  "last_attempt": "string",
  "created": "string",
  "updated": "string",
  "role": "string",
  "language": "string",
  "contacts": [
    {
      "id": "string",
      "user_id": "string",
      "data_source": "string",
      "type": "string",
      "contact": "string",
      "created": "string",
      "updated": "string",
      "can_notify": "string"
    }
  ],
  "allowed_privileges": [
    "string"
  ],
  "gravatar": "string"
}

delete user

delete

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

idintegerOptional

urlstringOptional

emailstringOptional

realnamestringOptional

loginsintegerOptional

failed_attemptsintegerOptional

last_loginstringOptional

last_attemptstringOptional

createdstringOptional

updatedstringOptional

rolestringOptional

languagestringOptional

allowed_privilegesstring[]Optional

gravatarstringOptional

404

Not Found

application/json

delete

/api/v3/users/80

HTTPcURLJavaScriptPython

DELETE /api/v3/users/80 HTTP/1.1
Host: ushahididocs.api.ushahidi.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 8,
  "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/8",
  "email": "[email protected]",
  "realname": "CannotEditor",
  "logins": 0,
  "failed_attempts": 0,
  "created": "1970-01-01T00:00:00.000Z",
  "role": "noedit",
  "contacts": [],
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "delete",
    "search",
    "read_full",
    "register"
  ],
  "gravatar": "751293f3d634b7f892f5441b2741abe6"
}

get account/admin user

get

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

OK

application/json

idintegerOptional

urlstringOptional

emailstringOptional

realnamestringOptional

loginsintegerOptional

failed_attemptsintegerOptional

last_loginstringOptional

last_attemptstringOptional

createdstringOptional

updatedstringOptional

rolestringOptional

languagestringOptional

allowed_privilegesstring[]Optional

gravatarstringOptional

401

Unauthorized

application/json

get

/api/v3/users/me

HTTPcURLJavaScriptPython

GET /api/v3/users/me HTTP/1.1
Host: ushahididocs.api.ushahidi.io
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "id": 2,
  "url": "https://ushahididocs.api.ushahidi.io//api/v3/users/2",
  "email": "[email protected]",
  "realname": "Admin",
  "logins": 0,
  "failed_attempts": 0,
  "created": "1970-01-01T00:00:00.000Z",
  "role": "admin",
  "contacts": [],
  "allowed_privileges": [
    "read",
    "create",
    "update",
    "search",
    "read_full",
    "register"
  ],
  "gravatar": "3578216d69634e299351bb18b7c7fc46"
}