Create a new user belonging to the specified customer.

{
  // required
  "username": "unqiue user identifier",
  // optional, default is a randomly generated password
  // Useful to leave as default if User is to be sent an activation email,
  // allowing them to set the password as required upon activation
  "password": "<password>",
  //optional
  "email": "<email>",
  //optional
  "name": "<name>",
  // optional, default is ""
  // comma separated list of roles to assign new user
  "roles": "<roles>",
  // optional, default is ""
  // comma separated list of Auth policy guids to assign new user
  "authpolicies": "<authpolicies>",
  // optional, default is false
  // whether or not an activation invite email should be sent to the user
  "invite": false
}

Update an existing user belonging to the specified customer.

{
  //required, and it can not be changed
  "username": "<unique user identifier>",
  // all fields are optional
  // email address of user to update
  "email": "<email>",
  "name": "<name>",
  "password": "<password>",
  //user won't be able to login if this is set to true
  "enabled": false,
  //if this is set to true, if will return a special flag next time the user logged in,
  //this flag can be used to delete application data on the device
  "blacklisted": false,
  // comma separated list of roles to set for this user for example, 'dev, analytics'
  "roles": "<roles>",
  // comma separated list of Auth policy guids to set for this user
  "authpolicies": "<authpolicies>"
}

Delete a user. The user must not have any Apps, otherwise the deletion will fail.

{
  // required
  // username of user to delete
  "username": "<unique user identifier>",
}

Read a user information based on the user name.

{
  // required
  // user name of the user to delete
  "username": "<unique user identifier>",
}

{
  "status": "ok",
  "fields": {
    "username": "<unique user identifier>",
    "email": "<email>",
    "name": "<name>",
    "enabled": false,
    "blacklisted": false,
    "roles": [<an array of role string>],
    "authpolicies": [<an array of Auth policy guids>],
    "lastLogin" : "<timestamp of last login>"
  }
}

{
  "status": "error",
  "message": "<error_message>"
}

List users.

{}

Enable/disable an existing user.

{
  // required
  // username of user to update
  "username": "<unique user identifier>",
  "enabled": true/false
}

Add new roles or remove existing roles of a user.

{
  // required
  // username of the user to update
  "username": "<unique user identifier>",
  // comma separated list of roles to set for this user for example, 'dev, analytics'
  "roles": "<roles>"
}

Add new Auth policies to or remove existing Auth policies from a user.

{
  // required
  // username of the user to update
  "username": "<unique user identifier>",
  // comma separated list of Auth policy guids to set for this user
  "authpolicies": "<authpolicies>"
}

List a user’s devices.

{
  //required
  "username": "<unique user identifier>"
}

List a user’s apps he/she has installed (But the app maybe deleted).

{
  //required
  "username" : "<unique user identifier>"
}