Users API
Users
Users are resources that have access to the Nosto admin portal. Users can't be created via API but are created by individuals following the invitation flow.
Properties
id
integer
X
User Id
username
string
X
Username
name
string
✔
First name
surname
string
✔
Last name
string
✔
description
string
✔
Notes on User
distances
string
metric
imperial
✔
Distance unit system to use when handling geo location distances
acl_groups
string or array
Admin = 1
Moderator = 2
Developer = 3
✔
A list of acl group ids, comma separated or JSON array when used in JSON body
last_login
datetime
X
User's last login datetime
created_at
timestamp
X
User's creation time
updated_at
timestamp
X
User's modification time
GET users
Retrieves all users available in the Stack.
Resource URL
https://api.stackla.com/api/users
Resource Details
Rate limited: Yes
Access scope: User
Request Parameters
page
No
query
Page number. Default value is 1
limit
No
query
Return limit define how many Users will be return for each request. Default is 25. Maximum limit is 100.
order_by
No
query
Return Users ordered by either id, name, email, surname, username, created
. Sorts by id
by default.
order_by_direction
No
query
Return ordered list of Users in either ascending (asc
) or descending (desc
) direction. Default is asc
.
GET users/:userId
Retrieves a specific user available in the Stack by its ID.
Resource URL
https://api.stackla.com/api/users/:userId
Resource Details
Rate limited: Yes
Access scope: User
Request Parameters
userId
Yes
Request type
ID of the User
PUT users/:userId
Updates a specific user available in the Stack by its ID.
Resource URL
https://api.stackla.com/api/users/:userId
Resource Details
Rate limited: Yes
Access scope: User
Request Parameters
userId
Yes
endpoint
ID of the User
DELETE users/:userId
Deletes a specific user available in the Stack by its ID.
Resource URL
https://api.stackla.com/api/users/:userId
Resource Details
Rate limited: Yes
Access scope: User
Request Parameters
userId
Yes
endpoint
ID of the User