orchestrator
2021.10
false
- Getting Started
 - Authentication
 - 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
 - Robots Requests
 - Roles Requests
 - Schedules Requests
 - Settings Requests
 - Tasks Requests
 - Task Catalogs Requests
 - Task Forms Requests
 - Tenants Requests
 - Transactions Requests
 - Users Requests
 - Webhooks Requests
 
 - Platform Management APIs
 

OUT OF SUPPORT
Orchestrator API Guide
Last updated Oct 31, 2024
POST
{OrchestratorURL}/odata/Folders/UiPath.Server.Configuration.OData.AssignUsers
Request headers
| 
                                  Key  | 
                                  Value  | 
|---|---|
| 
                                  Authorization  | 
                                  Bearer  | 
Request body
{
  "assignments": {
    "UserIds": [58571],
    "RolesPerFolder": [
      {
        "FolderId": 14091,
        "RoleIds": [25]
      }
    ]
  }
}{
  "assignments": {
    "UserIds": [58571],
    "RolesPerFolder": [
      {
        "FolderId": 14091,
        "RoleIds": [25]
      }
    ]
  }
}Response code
204 No Content
GET
{OrchestratorURL}/odata/Folders/UiPath.Server.Configuration.OData.GetUsersForFolder(key=14089,includeInherited=true)?$expand=UserEntity%2CRoles
Request headers
| 
                                  Key  | 
                                  Value  | 
|---|---|
| 
                                  Authorization  | 
                                  Bearer  | 
Response code
200 OK
Response body
{
  "@odata.context": "{OrchestratorURL}/odata/$metadata#UserRoles",
  "@odata.count": 2,
  "value": [
    {
      "Id": 52454,
      "UserEntity": {
        "UserName": "admin",
        "IsInherited": true,
        "Id": 52454
      },
      "Roles": [
        {
          "Name": "Administrator",
          "Origin": "Assigned",
          "Id": 13
        },
        {
          "Name": "Test",
          "Origin": "Assigned",
          "Id": 25
        }
      ]
    },
    {
      "Id": 58571,
      "UserEntity": {
        "UserName": "Petrix",
        "IsInherited": false,
        "Id": 58571
      },
      "Roles": [
        {
          "Name": "Test",
          "Origin": "Assigned",
          "Id": 25
        }
      ]
    }
  ]
}{
  "@odata.context": "{OrchestratorURL}/odata/$metadata#UserRoles",
  "@odata.count": 2,
  "value": [
    {
      "Id": 52454,
      "UserEntity": {
        "UserName": "admin",
        "IsInherited": true,
        "Id": 52454
      },
      "Roles": [
        {
          "Name": "Administrator",
          "Origin": "Assigned",
          "Id": 13
        },
        {
          "Name": "Test",
          "Origin": "Assigned",
          "Id": 25
        }
      ]
    },
    {
      "Id": 58571,
      "UserEntity": {
        "UserName": "Petrix",
        "IsInherited": false,
        "Id": 58571
      },
      "Roles": [
        {
          "Name": "Test",
          "Origin": "Assigned",
          "Id": 25
        }
      ]
    }
  ]
}The 
               
               IsPersonal boolean property in the response body of the \FolderNavigation\GetFolderNavigationContextForCurrentUser endpoint checks if the folder with the queried ID (for example, 302428) is a personal workspace.
               GET
{OrchestratorURL}/api/FoldersNavigation/GetFolderNavigationContextForCurrentUser?folderId=302428
Request headers
| 
                                  Key  | 
                                  Value  | 
|---|---|
| 
                                  Authorization  | 
                                  Bearer  | 
Response code
200 OK
Response body
{
    "Id": 302428,
    "DisplayName": "[email protected]'s workspace",
    "IsSelectable": true,
    "IsPersonal": true,
    "ProvisionType": "Automatic",
    "Ancestors": [],
    "ChildrenPage": [],
    "ChildrenCount": 0
}{
    "Id": 302428,
    "DisplayName": "[email protected]'s workspace",
    "IsSelectable": true,
    "IsPersonal": true,
    "ProvisionType": "Automatic",
    "Ancestors": [],
    "ChildrenPage": [],
    "ChildrenCount": 0
}