Removes user(s) who are not part of any active classes, pocs, or environments, and supports the replacement of users who are part of any active classes, pocs, or environments.
* Each request is limited to one project id, one team id, and one role. Multiple calls should be made if you wish to remove users from different projects, teams within a project, and/or different user roles.
** All body parameters need to coincide in order to implement any changes. The project id, team id, and role must match to the user id.
*** In order to remove an active user, you can replace them with another user. Use the replace user query parameter and the relevant user id to replace and remove users. The replacement user will receive ownership of any end-user environments, policies, and invitations.
Request Path
POST /api/v3/users/Actions/RemoveUserRole?replacingUserId={userId}
Request Payload
{
users: [{id:
projectId:
teamId:
role:
}
Body Parameters
Body parameter | Type | Description |
users |
Array[user] | Required. The user id that will replace an existing user. The users must be a part of the same project, team, and must have the same role. |
projectId |
string | Required. The project id which the user is a part of. Only one project id can be specified per call. |
teamId |
string | Required for all roles except if role = 8. The team id which the users are a part of. Only one team id can be specified per call. |
role |
enum[Role] | Required. The role which the users share. Only one role can be specified per call. 2=TeamMember, 4=TeamManager, 8=ProjectManager. |
Query Parameters
Query parameter | Type | Description |
replacingUserId |
string | Optional |
Request Example
{ "users": [{id:"USMVysHnO_uN8v0OX8CUhBbq2"}, {id:"USMVysHnO_uN8v0OX8CUhBbq3"}], "projectId": "PRjTcEu83MXmpDAHTf47b-QQ2", "teamId": "TMXrjiUu7WTjGuctqTUJ0wXQ2", "role": 2 }
Response Example
{ results: [ { invitee :{ email: string, firstName: string, lastName: string }, success : true/false, errorMsg: string, }, ... ] }
Error Response Example
{ "message": <string>, "code": <string>, "exceptionMessage": <string>, "exceptionType": <string>, "stackTrace": <string> }
Possible Error strings
Error | Description | String |
InvalidApiParameterException | If one of the ids supplied by the user is not valid. OR Request body parameters don’t coincide. |
Request body parameters don’t match. |
PermissionDeniedException | If the requesting user does not have permission to remove these users. | Request cannot be completed due to missing permissions. |
General error | An error has occurred while processing the request, please try again. If the problem persists please contact support for help. | |
PermissionDeniedException | User(s) must be replaced in order to remove them. | User(s) are active and must be replaced in order to be removed. |