UiPath Documentation
orchestrator
2023.4
false
Orchestrator API guide

Delete Users

Deletes multiple users from an organization, based on the users IDs.

API Endpoint​

DELETE https://{yourDomain}/identity/api/User

Scopes​

Requires the following scopes:

  • PM.User
  • PM.User.Write

Request Headers​

--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json'
Note:

To obtain the {access_token}, make sure to authenticate through one of the methods described here.

Path Parameters​

Path paramData typeDescription
partitionGlobalId

(required)
StringThe ID of the organization you want to retrieve the robot accounts for.

Request Body​

The request body contains the list of user IDs you want to bulk delete from the organization.

{
  "partitionGlobalId": "string",
  "userIds": [
    "string"
  ]
}
{
  "partitionGlobalId": "string",
  "userIds": [
    "string"
  ]
}

Responses​

204 Success​

The indicated robot accounts are deleted from the organization.

Example Request​

Let's say you gathered all the information needed to build the API call.

  • Your {baseURL} is: https://{yourDomain}/identity
  • Your {access_token} is: 1234 (for length considerations).
  • The {partitionGlobalId} is: 3fa85f64-5717-4562-b3fc-2c963f66afa6
  • The users you want to delete have the following IDs:
    • Dolores Umbridge: dol-2908
    • Quirinus Quirrell: qui-2609

The call should resemble the following example (cURL):

curl --location --request DELETE 'https://{yourDomain}/identity/api/User' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
    "partitionGlobalId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "userIds": [
        "dol-2908", "qui-2609"
    ]
}'
curl --location --request DELETE 'https://{yourDomain}/identity/api/User' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
--data-raw '{
    "partitionGlobalId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "userIds": [
        "dol-2908", "qui-2609"
    ]
}'
  • API Endpoint​
  • Scopes​
  • Request Headers​
  • Path Parameters​
  • Request Body​
  • Responses​
  • 204 Success​
  • Example Request​

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated