orchestrator
latest
false
- Getting started
- Introduction
- About OData and references
- Enumerated types
- Authenticating
- Building API requests
- Permissions per endpoint
- Response codes
- Rate limits and large data field usage optimization
- Rate limits
- 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
- Process data retention policy 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
Orchestrator API guide
Last updated Nov 27, 2025
The following DELETE request to the
/odata/ReleaseRetention({key}) endpoint allows you to reset the existing retention policy of the specified process to the default built-in policy.
Note: By calling the DELETE endpoint for processes that have the default migration policy in place (that is, 120 days + deletion),
it replaces it with the built-in retention policy of 30 days +deletion.
API endpoint
DELETE
https://<customURL>.dedicated.uipath.com/{organizationName}/{tenantName}/orchestrator_/odata/ReleaseRetention({key})Request headers
--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json' \
--header 'X-UIPATH-OrganizationUnitId: {the_ID_of_the_folder_that_contains_the_process}' \--header 'Authorization: Bearer {access_token}'\
--header 'Content-Type: application/json' \
--header 'X-UIPATH-OrganizationUnitId: {the_ID_of_the_folder_that_contains_the_process}' \Path parameters
|
Param |
Data type |
Description |
|---|---|---|
|
(required) |
Int64 |
The ID of the process for which you want to reset the retention policy to default. |
204 Success
Resets the indicated process policy to the default one of 30-day retention + deletion.
Example request
Let's say you gathered all the information needed to build the API call.
- The
{key}is:6789. This is the ID of the process for which you want to reset the specific retention policy to default. -
The
X-UIPATH-OrganizationUnitIdrequest header value is202020. This is the ID of the folder that contains the process for which you want to reset the custom retention policy to default. Learn how to identify the folder ID.curl --location --request DELETE 'https://<customURL>.dedicated.uipath.com/{organizationName}/{tenantName}/orchestrator_/odata/ReleaseRetention(6789)' \ --header 'Authorization: Bearer 1234' \ --header 'Content-Type: application/json' \ --header 'X-UIPATH-OrganizationUnitId: 202020'curl --location --request DELETE 'https://<customURL>.dedicated.uipath.com/{organizationName}/{tenantName}/orchestrator_/odata/ReleaseRetention(6789)' \ --header 'Authorization: Bearer 1234' \ --header 'Content-Type: application/json' \ --header 'X-UIPATH-OrganizationUnitId: 202020'A successful call (response code 204) resets the custom policy to the default one.
In the Orchestrator UI, the change is also visible in the Audit details of the corresponding process Update feature action.