Remove User Roles

Remove a role of the user without logging in to Application Portal.

Operation Permissions

In Application Portal, the application must be granted the “Authorize users in this OU” permission.

Request Format

POST https://{apigw-address}/app-portal-service/v2.2/role/removeRoles

Request Parameters (Body)

Name Mandatory/Optional Data Type Description
organizationId Mandatory String The organization ID. How to get organizationld>>
userId Mandatory String The user ID.
roleIds Mandatory List The ID of the role to remove for the user.

Response Parameters

Name Data Type Description
data Boolean true indicates that the removal was successful, false indicates that the removal failed.

Error Codes

Code Description
31400 Errors such as incorrect parameters, empty parameters, character limits exceeded, and so on.
31403 The application has not been granted the “Authorize users in this OU” permission.
31404 Organization not found.

Samples

Request Sample

url: https://{apigw-address}/app-portal-service/v2.2/role/removeRoles

method: POST

requestBody:
{"organizationId":"yourOrgId", "userId":"yourUserId","roleIds": ["role1","role2","role3"]}

Return Sample

{
  "code": 0,
  "message": "OK",
  "data": true
}

Java SDK Sample

public class AppPortalSdkTest{
    @Test
    public void removeUserRoles() {
            ArrayList<String> roleIds = new ArrayList<>();
            roleIds.add("role1");
            RolesRemoveRequest rolesRemoveRequest = new RolesRemoveRequest("your_org_id", "your_user_id",roleIds);
            Response response = Poseidon.config(PConfig.init().appKey("your_access_key").appSecret("your_secret_key").debug())
                    .url("https://{apigw-address}").getResponse(rolesRemoveRequest, Response.class);

            System.out.println("List organization res: " + JSON.toJSONString(response));

            assertNotNull("Response should not be null", rolesRemoveRequest);
            assertNotNull("Response data should not be null", response.data);

    }
}