List trashed workflows in Dynatrace Automation API for the current user or all users with admin access, with paging and ordering.
| GET | SaaS | https://{your-environment-id}.apps.dynatrace.com/platform/automation/v1/trash/workflows |
You use this operation to list workflows that have been moved to trash. The adminAccess, limit, offset, and ordering query parameters control access and paging, and the response returns the matching trashed workflows.
To execute this request, you need a platform token or OAuth access token with automation:workflows:read scope. To learn how to obtain and use it, see Tokens and authentication.
| Parameter | Type | Description | In | Required |
|---|---|---|---|---|
| adminAccess | boolean | Allow access to all workflows/executions - additionally requires automation:workflows:admin | query | Optional |
| limit | integer | Number of results to return per page. | query | Optional |
| offset | integer | The initial index from which to return the results. | query | Optional |
| ordering | string | Which field to use when ordering the results. | query | Optional |
| Code | Type | Description |
|---|---|---|
| 200 | Paginated | - |
| 4XX | Error | - |
PaginatedTrashedWorkflowList object| Element | Type | Description |
|---|---|---|
| count | integer | - |
| results | Trashed | - |
TrashedWorkflow object| Element | Type | Description |
|---|---|---|
| id | string | - |
| title | string | - |
| deletionInfo | object | - |
| purgeAt | string | When the workflow will be automatically and permanently deleted after the retention period. |
| isDeployed | boolean | - |
ErrorEnvelope object| Element | Type | Description |
|---|---|---|
| error | Error | - |
Error object| Element | Type | Description |
|---|---|---|
| message | string | - |
| code | integer | - |
| details | Error | - |
ErrorDetails object| Element | Type | Description |
|---|---|---|
| errorCode | string | - |
| errorRef | string | - |
{"count": 123,"results": [{"id": "string","title": "string","deletionInfo": {"deletedBy": "string","deletedTime": "string"},"purgeAt": "string","isDeployed": true}]}
{"error": {"message": "string","code": 1,"details": {"errorCode": "string","errorRef": "string"}}}