orchestrator
2024.10
true
  • Getting Started
  • Swagger Definition
  • Orchestrator APIs
UiPath logo, featuring letters U and I in white
Orchestrator API Guide
Automation CloudAutomation Cloud Public SectorAutomation SuiteStandalone
Last updated Nov 11, 2024

Folders Requests

Assigning a User to a Folder With a Specified Role

POST

https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/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

Getting All the Users in a Folder and Their Roles

GET

https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/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": "https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/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": "https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/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
        }
      ]
    }
  ]
}

Checking If a Folder Is a Personal Workspace

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

https://{yourDomain}/{organizationName}/{tenantName}/orchestrator_/api/FoldersNavigation/GetFolderNavigationContextForCurrentUser?folderId=302428

Request headers

Key

Value

Authorization

Bearer

Response code

200 OK

Response body

{
    "Id": 302428,
    "DisplayName": "rachel.green@friends.com's workspace",
    "IsSelectable": true,
    "IsPersonal": true,
    "ProvisionType": "Automatic",
    "Ancestors": [],
    "ChildrenPage": [],
    "ChildrenCount": 0
}{
    "Id": 302428,
    "DisplayName": "rachel.green@friends.com's workspace",
    "IsSelectable": true,
    "IsPersonal": true,
    "ProvisionType": "Automatic",
    "Ancestors": [],
    "ChildrenPage": [],
    "ChildrenCount": 0
}

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.