User
The User endpoint provides methods for retrieving and updating information related to your account, as well as inviting new users.
Get a list of users.
GET
https://api.halosecurity.com/api/v1/user/list.json
Returns a paginated list of users. Requires account_user
permission.
Learn about permissions: Permissions
https://www.halosecurity.com/user/account/users
Query Parameters
sort
Integer
0
= email (default)
sort_desc
Integer
0
= No (default)
1
= Yes
String
Filter by email
name
String
Filter by name
{
"list": [
{
"role": 3,
"user_id": 1,
"phone": "1-000-000-0000",
"last_name": "Doe",
"title": "CEO",
"first_name": "Jon",
"email": "[email protected]"
}
]
}
Get the details of a user.
GET
https://api.halosecurity.com/api/v1/user/get.json
Returns the details of a user. If not me
, requires account_user
permission.
Learn about permissions: Permissions
https://www.halosecurity.com/user/account/users
Query Parameters
user_id*
Integer
{
"user": {
"role": 3,
"user_id": 1,
"phone": "1-000-000-0000",
"last_name": "Smith",
"title": "CEO",
"first_name": "Jon",
"email": "[email protected]"
}
}
Get the details of me.
GET
https://api.halosecurity.com/api/v1/user/me.json
Returns the details of me.
https://www.halosecurity.com/user/account/users
{
"user": {
"role": 1,
"user_id": 1,
"phone": "1-000-000-0000",
"last_name": "Smith",
"title": "CEO",
"first_name": "Jon",
"email": "[email protected]"
}
}
Update the details of a user.
GET
https://api.halosecurity.com/api/v1/user/update.json
If not me
, requires account_user
permission.
Learn about permissions: Permissions
https://www.halosecurity.com/user/account/users
Query Parameters
user_id*
Integer
first_name
String
last_name
String
title
String
phone
String
{
"success": 1
}
Invite a new user.
GET
https://api.halosecurity.com/api/v1/user/invite.json
Requires account_user
permission.
Learn about permissions: Permissions
https://www.halosecurity.com/user/account/add-user
Query Parameters
email*
String
role*
Integer
first_name
String
last_name
String
phone
Integer
{
"success": 1
}
Last updated
Was this helpful?