- Getting Started
- Swagger Definition
- Orchestrator APIs
- Alerts Requests
- Assets Requests
- Calendars Requests
- Environments Requests
- Folders Requests
- Generic Tasks Requests
- Jobs Requests
- Libraries Requests
- License Requests
- Packages Requests
- Permissions Requests
- Processes Requests
- Queue Items Requests
- Robots Requests
- Roles Requests
- Schedules Requests
- Settings Requests
- Tasks Requests
- Task Catalogs Requests
- Task Forms Requests
- Tenants Requests
- Transactions Requests
- Users Requests
- Webhooks Requests
Users Requests
- GET requests to the
/odata/Usersor/odata/Users({})endpoints return an empty Domain for AD users. - The
GetOrganizationUnits(Id)andGetRoles(Id)requests only return folders and roles explicitly set for an auto-provisioned user. The ones inherited from the group configuration can be retrieved through the/api/DirectoryService/GetDirectoryPermissions?userId={userId}endpoint.
The following example enables you to change the language for the user with the 749 Id to Japanese.
POST
{OrchestratorURL}/odata/Users(749)/UiPath.Server.Configuration.OData.ChangeUserCulture
PUT
{OrchestratorURL}/odata/Users(13)
{
"RobotProvision": {
"UserName": "uipath\\john.smith",
"RobotId": 53,
"RobotType": "Development",
"ExecutionSettings": {}
}
}{
"RobotProvision": {
"UserName": "uipath\\john.smith",
"RobotId": 53,
"RobotType": "Development",
"ExecutionSettings": {}
}
}You can use this endpoint to assign one or more roles to the specified user ID, which can be the ID of a group, a user account, or a robot account.
POST
{OrchestratorURL}/odata/Users(9)/UiPath.Server.Configuration.OData.AssignRoles
{
"roleIds": [
1,3
]
}{
"roleIds": [
1,3
]
}Example
9 by overwriting its assigned roles with the roles that have IDs 1 and 3.
|
Roles before request |
Roles after request |
Changes |
|---|---|---|
|
No roles |
1 and 3 |
Roles with IDs
1 and 3 have been assigned.
|
|
Roles with IDs
1 and 2 |
1 and 3 |
Role with ID
2 was removed and role with ID 3 was assigned.
|
|
Role with ID
2 |
1 and 3 |
Role with ID
2 was removed, and roles with IDs 1 and 3 were assigned.
|
cURL
curl -X POST "https://{server}/{OrgName}/{TenantName}/orchestrator_/odata/Users({key})/UiPath.Server.Configuration.OData.AssignRoles"
-H "accept: application/json" -H "Content-Type: application/json" -d "{ \"roleIds\": [ {RoleID1},{RoleID2} ] }"
https://<OrchestratorURL>/swagger)
Here's an example procedure for how to assign roles to an account:
-
Make a GET request at
/odata/Rolesto retrieve the list of roles.You can use any type of filter that OData supports, if needed.
- Note the IDs for the roles you want to assign.
-
Make a GET request at
/odata/Usersto retrieve the list of accounts.The list includes groups, user accounts, and robot accounts.
You can use any type of filter that OData supports, if needed.
- Note the IDs for the accounts to which you want to assign roles.
-
Make a POST request to
/odata/Users({key})/UiPath.Server.Configuration.OData.AssignRolesfor each account to which you want to assign roles.{key}is a single account ID for the account to which you want to assign roles{roleID}is a single role ID for the role you want to assign; you can list multiple IDs, separated by a comma.
