@ -65,7 +82,7 @@ public interface UserManagementService {
produces=MediaType.APPLICATION_JSON,
produces=MediaType.APPLICATION_JSON,
httpMethod="POST",
httpMethod="POST",
value="Adding a User",
value="Adding a User",
notes="WSO2 EMM supports user management. Add a new user to the WSO2 EMM user management system via this REST API",
notes="WSO2 IoTS supports user management. Add a new user to the WSO2 IoTS user management system via this REST API",
tags="User Management",
tags="User Management",
authorizations={
authorizations={
@Authorization(
@Authorization(
@ -126,7 +143,7 @@ public interface UserManagementService {
produces=MediaType.APPLICATION_JSON,
produces=MediaType.APPLICATION_JSON,
httpMethod="GET",
httpMethod="GET",
value="Getting Details of a User",
value="Getting Details of a User",
notes="Get the details of a user registered with WSO2 EMM using the REST API.",
notes="Get the details of a user registered with WSO2 IoTS using the REST API.",
response=BasicUserInfo.class,
response=BasicUserInfo.class,
tags="User Management",
tags="User Management",
authorizations={
authorizations={
@ -267,7 +284,7 @@ public interface UserManagementService {
@ApiOperation(
@ApiOperation(
httpMethod="DELETE",
httpMethod="DELETE",
value="Deleting a User",
value="Deleting a User",
notes="When an employee leaves the organization, you can remove the user details from WSO2 EMM using this REST API.",
notes="When an employee leaves the organization, you can remove the user details from WSO2 IoTS using this REST API.",
tags="User Management",
tags="User Management",
authorizations={
authorizations={
@Authorization(
@Authorization(
@ -280,7 +297,7 @@ public interface UserManagementService {
@ApiResponses(value={
@ApiResponses(value={
@ApiResponse(
@ApiResponse(
code=200,
code=200,
message="OK. \n Successfully removed the user from WSO2 EMM."),
message="OK. \n Successfully removed the user from WSO2 IoTS."),
@ApiResponse(
@ApiResponse(
code=404,
code=404,
message="Not Found. \n The specified resource does not exist.",
message="Not Found. \n The specified resource does not exist.",
@ -312,7 +329,7 @@ public interface UserManagementService {
produces=MediaType.APPLICATION_JSON,
produces=MediaType.APPLICATION_JSON,
httpMethod="GET",
httpMethod="GET",
value="Getting the Role Details of a User",
value="Getting the Role Details of a User",
notes="A user can be assigned to one or more role in EMM. Using this REST API you can get the role/roles a user is assigned to.",
notes="A user can be assigned to one or more role in IoTS. Using this REST API you can get the role/roles a user is assigned to.",
tags="User Management",
tags="User Management",
authorizations={
authorizations={
@Authorization(
@Authorization(
@ -375,7 +392,7 @@ public interface UserManagementService {
produces=MediaType.APPLICATION_JSON,
produces=MediaType.APPLICATION_JSON,
httpMethod="GET",
httpMethod="GET",
value="Getting Details of Users",
value="Getting Details of Users",
notes="You are able to manage users in WSO2 EMM by adding, updating and removing users. If you wish to get the list of users registered with WSO2 EMM, you can do so "
notes="You are able to manage users in WSO2 IoTS by adding, updating and removing users. If you wish to get the list of users registered with WSO2 IoTS, you can do so "
+"using this REST API",
+"using this REST API",
tags="User Management",
tags="User Management",
authorizations={
authorizations={
@ -389,7 +406,7 @@ public interface UserManagementService {
@ApiResponses(value={
@ApiResponses(value={
@ApiResponse(
@ApiResponse(
code=200,
code=200,
message="OK. \n Successfully fetched the list of users registered with WSO2 EMM.",
message="OK. \n Successfully fetched the list of users registered with WSO2 IoTS.",
response=BasicUserInfoList.class,
response=BasicUserInfoList.class,
responseHeaders={
responseHeaders={
@ResponseHeader(
@ResponseHeader(
@ -414,7 +431,7 @@ public interface UserManagementService {
response=ErrorResponse.class),
response=ErrorResponse.class),
@ApiResponse(
@ApiResponse(
code=500,
code=500,
message="Internal Server Error. \n Server error occurred while fetching the list of WSO2 EMM users.",
message="Internal Server Error. \n Server error occurred while fetching the list of WSO2 IoTS users.",
response=ErrorResponse.class)
response=ErrorResponse.class)
})
})
ResponsegetUsers(
ResponsegetUsers(
@ -449,7 +466,7 @@ public interface UserManagementService {
produces=MediaType.APPLICATION_JSON,
produces=MediaType.APPLICATION_JSON,
httpMethod="GET",
httpMethod="GET",
value="Getting the User Count",
value="Getting the User Count",
notes="Get the number of users in WSO2 EMM via this REST API.",
notes="Get the number of users in WSO2 IoTS via this REST API.",
tags="User Management",
tags="User Management",
authorizations={
authorizations={
@Authorization(
@Authorization(
@ -474,7 +491,7 @@ public interface UserManagementService {
response=ErrorResponse.class),
response=ErrorResponse.class),
@ApiResponse(
@ApiResponse(
code=500,
code=500,
message="Internal Server Error. \n Server error occurred while fetching the total number of users in WSO2 EMM.",
message="Internal Server Error. \n Server error occurred while fetching the total number of users in WSO2 IoTS.",
response=ErrorResponse.class)
response=ErrorResponse.class)
})
})
ResponsegetUserCount();
ResponsegetUserCount();
@ -608,7 +625,7 @@ public interface UserManagementService {
produces=MediaType.APPLICATION_JSON,
produces=MediaType.APPLICATION_JSON,
httpMethod="PUT",
httpMethod="PUT",
value="Changing the User Password",
value="Changing the User Password",
notes="A user is able to change the password to secure their WSO2 EMM profile via this REST API.",
notes="A user is able to change the password to secure their WSO2 IoTS profile via this REST API.",
tags="User Management",
tags="User Management",
authorizations={
authorizations={
@Authorization(
@Authorization(
@ -653,8 +670,8 @@ public interface UserManagementService {
produces=MediaType.APPLICATION_JSON,
produces=MediaType.APPLICATION_JSON,
httpMethod="POST",
httpMethod="POST",
value="Sending Enrollment Invitations to Users",
value="Sending Enrollment Invitations to Users",
notes="Send the users a mail inviting them to download the EMM mobile application on their devices using the REST API given below.\n" +
notes="Send the users a mail inviting them to enroll their devices using the REST API given below.\n" +
"Before running the REST API command to send the enrollment invitations to users make sure to configure WSO2 EMM as explained in step 4, under the WSO2 EMM general server configurations documentation.",
"Before running the REST API command to send the enrollment invitations to users make sure to configure WSO2 IoTS as explained in step 4, under the WSO2 IoTS general server configurations documentation.",
tags="User Management",
tags="User Management",
authorizations={
authorizations={
@Authorization(
@Authorization(
@ -691,4 +708,47 @@ public interface UserManagementService {
value="List of users",
value="List of users",
required=true)List<String>usernames);
required=true)List<String>usernames);
@POST
@Path("/enrollment-invite")
@ApiOperation(
produces=MediaType.APPLICATION_JSON,
httpMethod=HTTPConstants.HEADER_POST,
value="Sending Enrollment Invitations to email address",
notes="Send the a mail inviting recipients to enroll devices.",