- 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
- Personal Workspaces Requests
- Processes Requests
- Process Data Retention Policy Requests
- Queue Items Requests
- Queue Retention Policy Requests
- Robots Requests
- Roles Requests
- Schedules Requests
- Settings Requests
- Storage Bucket Requests
- Tasks Requests
- Task Catalogs Requests
- Task Forms Requests
- Tenants Requests
- Transactions Requests
- Users Requests
- Webhooks Requests
Orchestrator API Guide
- 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.
DELETE
https://govcloud.uipath.us/{organizationName}/{tenantName}/orchestrator_/odata/Users(446)
Request headers
|
Key |
Value |
|---|---|
|
Authorization |
Bearer |
Response code
204 No content
The following example enables you to change the language for the user with the 749 Id to Japanese.
POST
https://govcloud.uipath.us/{organizationName}/{tenantName}/orchestrator_/odata/Users(749)/UiPath.Server.Configuration.OData.ChangeUserCulture
Request headers
|
Key |
Value |
|---|---|
|
Authorization |
Bearer |
Request body
{
"culture": "ja"
}{
"culture": "ja"
}Response code
200 OK
PUT
https://govcloud.uipath.us/{organizationName}/{tenantName}/orchestrator_/odata/Users(13)
Request headers
|
Key |
Value |
|---|---|
|
Authorization |
Bearer |
Request body
{
"RobotProvision": {
"UserName": "uipath\\john.smith",
"RobotId": 53,
"RobotType": "Development",
"ExecutionSettings": {}
}
}{
"RobotProvision": {
"UserName": "uipath\\john.smith",
"RobotId": 53,
"RobotType": "Development",
"ExecutionSettings": {}
}
}Response code
200 OK
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
https://govcloud.uipath.us/{organizationName}/{tenantName}/orchestrator_/odata/Users(9)/UiPath.Server.Configuration.OData.AssignRoles
Request headers
|
Key |
Value |
|---|---|
|
Authorization |
Bearer |
Request body
{
"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://govcloud.uipath.us/{organizationName}/{tenantName}/orchestrator_/odata/Users({key})/UiPath.Server.Configuration.OData.AssignRoles" -H "accept: application/json" -H "Content-Type: application/json"
-d "{ \"roleIds\": [ {RoleID1},{RoleID2} ] }"
https://https://govcloud.uipath.us/{organizationName}/{tenantName}/orchestrator_/swagger)
Step by Step
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.
