Users¶

Listing¶

This endpoint returns a list of the users registered on the robot. Each user contains multiple properties: id (integer, internal identifier), email (string, associated email address), role (string, the level of privilege).

Note that emails are unique but can be changed, so don't use them as identifier in your system. Also the robot is only using them as usernames and not yet for verification, notifications, forgotten passwords, etc.

Request

GET /api/v1/users

Payload

NONE

Reply

{
  "users":[
    {"id":1,"email":"jean@perdu.com","role":"admin"},
    {"id":2,"email":"michel@perdu.com","role":"user"}
  ]
}

or an error.