POST
https://ushahididocs.api.ushahidi.io/api/v3/users
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
{
"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"
}
PUT
https://ushahididocs.api.ushahidi.io/api/v3/users/1
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
{
"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"
}
PUT
https://ushahididocs.api.ushahidi.io/api/v3/users/me
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
{
"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"
}
Sorting parameter Available values : entity fields Default value : id
Sorting parameter Available values : [ASC,DESC] Default value : ASC
Paging parameter Default value : null
Paging parameter Default value : 0
Filter parameter if this parameter is set then the api will return posts containing q text in name property
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
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": "test5@v3.ushahidi.com",
"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": "robbie@ushahidi.com",
"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": "admin@ushahidi.com",
"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": "test@v3.ushahidi.com",
"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": "importadmin@ushahidi.com",
"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": "demo@ushahidi.com",
"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": "manager@ushahidi.com",
"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": "importer@ushahidi.com",
"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": "sets@ushahidi.com",
"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": "settingsmanager@ushahidi.com",
"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": "test3@v3.ushahidi.com",
"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": "test4@v3.ushahidi.com",
"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
}
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": "test@v3.ushahidi.com",
"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"
}
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": "cannoteditor@ushahidi.com",
"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 /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": "admin@ushahidi.com",
"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"
}