UiPath Documentation
orchestrator
2023.4
false
  • Getting started
    • About OData and references
    • Enumerated types
    • Authenticating
    • Permissions per endpoint
    • Building API Requests
    • Response codes
    • Health check endpoints
  • Authentication
    • Authentication methods
    • External Applications (OAuth)
    • ROPC (not recommended)
  • Swagger definition
    • Read me
    • Authorizing API calls in Swagger
    • Managing logical resources
  • 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
    • Personal workspaces requests
    • Processes requests
    • Queue Items requests
    • Queue retention policy requests
    • Robots requests
    • Roles requests
    • Schedules requests
    • Settings requests
    • Storage bucket requests
    • Tasks requests
    • Task Catalogs requests
    • Task Forms requests
    • Tenants requests
    • Transactions requests
    • Users requests
    • Webhooks requests
  • Platform Management APIs
    • Getting started
      • About this guide
      • Available resources
      • API endpoint URL structure
      • Enumeration List
    • Scopes and permissions
      • About scopes and permissions
      • Platform Management scopes and permissions
    • Platform Management APIs
      • Audit Logs
        • Get Audit Logs
        • Download Audit Logs
      • Groups
        • Get All Groups
        • Get Specific Group
        • Delete Specific Group
        • Create a New Local Group
        • Update Group
      • Robot Account
        • Get All Robot Accounts
        • Delete Robot Accounts
        • Get Specific Robot Account
        • Delete Specific Robot Account
        • Create a New Robot Account
        • Update Robot Account
      • User
        • Update User
        • Delete Specific User
        • Delete Users
      • Settings
        • Get Settings
        • Update Settings
      • Message Template
        • Get Message Template
        • Update a Message Template
        • Get Message Template by Name
UiPath logo, featuring letters U and I in white

Orchestrator API guide

Last updated Feb 13, 2025

Delete Specific Robot Account

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

API Endpoint

DELETE https://{yourDomain}/{organizationName}/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 param

Data type

Description

partitionGlobalId

(required)

String

The ID of the organization you want to delete the robot accounts from.

robotAccountId

(required)

String

The 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}/{organizationName}/{tenantName}/
  • Your {access_token} is: 1234 (for length considerations).
  • The {partitionGlobalId} is: magic-7
  • The {robotAccountId} is: 33-ab

The call should look like below (cURL):

curl --location --request DELETE 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/RobotAccount/magic-7/33-ab' \
--header 'Authorization: Bearer 1234' \
--header 'Content-Type: application/json'curl --location --request DELETE 'https://{yourDomain}/{organizationName}/{tenantName}/identity_/api/RobotAccount/magic-7/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