orchestrator
2022.4
false
- 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
 

Orchestrator API guide
Last updated Feb 13, 2025
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
}