UiPath Documentation
orchestrator
2023.10
false
Orchestrator API guide

Delete Specific Robot Account

API reference for deleting a specific robot account from an organization by account ID

Deletes the specified robot account in an organization, based on the organization and robot account ID.

API Endpoint​

DELETE https://{yourDomain}/identity/api/RobotAccount/{partitionGlobalId}/{robotAccountId}

Scopes​

Requires the following scopes:

  • PM.RobotAccount
  • PM.RobotAccount.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 delete the robot accounts from.
robotAccountId (required)StringThe ID of the robot account you want to delete.

Responses​

204 Success​

The indicated robot account is 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 {robotAccountId} is: 33-ab

The call should resemble the following example (cURL):

curl --location --request DELETE 'https://{yourDomain}/identity/api/RobotAccount/3fa85f64-5717-4562-b3fc-2c963f66afa6/33-ab' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
curl --location --request DELETE 'https://{yourDomain}/identity/api/RobotAccount/3fa85f64-5717-4562-b3fc-2c963f66afa6/33-ab' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'
  • API Endpoint​
  • Scopes​
  • Request Headers​
  • Path Parameters​
  • Responses​
  • 204 Success​
  • Example Request​

Was this page helpful?

Connect

Need help? Support

Want to learn? UiPath Academy

Have questions? UiPath Forum

Stay updated