Retrieving user information is super simple, however there is some complexity that arises when permissions get involved.
Note: For #2, #3, and #4, the invited user can be an existing user. In those cases, we do not call the Create User
method, but rather call Respond to Invitation
GET /user
user:profile:read
Response
id
- stringemail
- stringname
- stringExample
$ http GET 'http://localhost:5000/user' 'Authorization: Bearer ACCESS_TOKEN'HTTP/1.1 200 OK{"id": "user_423a7fb0-9a5d-4abb-b3b7-1a3d92ada5cc","name": "Mariano Iglesias","just_created": false}
Limited permission view for use cases such as team members being able to view team schedules on the dashboard or to populate the organization directory.
This is used by organization admins to manage their users.
GET /users
organization:user:read
Response: Paginated Array
id
- stringemail
- stringname
- stringjust_created
- boolean: If set to true, a new user has been created as a result of login and as such the next request should be performed with a newly issued access token (to pickup any Auth0 role changes)role
- stringExample
$ http GET 'http://localhost:5000/users' 'Authorization: Bearer ACCESS_TOKEN'HTTP/1.1 200 OK{"cursor": "user_b21da9a0-b1fd-4b99-a12e-f321b93e2f7c","elements": [{"id": "user_2a52dc51-2844-4781-aef5-02f8b5074d06","just_created": false,"name": "Mariano Iglesias","role": "owner"},{"id": "user_423a7fb0-9a5d-4abb-b3b7-1a3d92ada5cc","just_created": false,"name": "Mariano Iglesias","role": "owner"},{"id": "user_b21da9a0-b1fd-4b99-a12e-f321b93e2f7c","just_created": false,"name": "Mariano Iglesias","role": "member"}]}
Enables admins to get all Tactic usage data for a user.