List trashed documents

Latest Dynatrace
Reference
Published Oct 13, 2026

List trashed documents in Dynatrace with the Document API, showing your deleted documents before they are permanently removed after 30 days.


GET	SaaS	`https://{your-environment-id}.apps.dynatrace.com/platform/document/v1/trash/documents`

Overview

You can use query parameters such as filter, page-key, page, page-size, and admin-access to narrow or page through results. Dynatrace returns the documents you own that are currently in the trash.

Authentication

To execute this request, you need a platform token or OAuth access token with document:trash.documents:read scope. To learn how to obtain and use it, see Tokens and authentication.

Parameters

Parameter	Type	Description	In	Required
filter	string	The filter parameter, as explained here. If this parameter is omitted, no filtering is applied and all your deleted documents will be returned. Filtering by string type parameters when using one of the operators `contains`, `starts-with` and `ends-with` is case insensitive. Filtering by `id` using the operators `contains`, `starts-with` and `ends-with` is only supported in case of user-given document ids. When using the equals operator or the not-equals operator, filtering is case sensitive. The following fields are legal filtering parameters - any other field names will result in a HTTP 400 response: `id`, `name`, `type`, `deletionInfo.deletedTime`, `deletionInfo.deletedBy` The following constraints apply: Parameter names are case-sensitive. Maximum nesting depth (via brackets) is 3. Maximum length is 1024 characters.	query	Optional
page-key	string	The page key is used to query results from the next page. You get a `nextPageKey` parameter in the return value of this method to use here. If this parameter is omitted, the first page will be returned.	query	Optional
page	integer	The page parameter is used to directly access a specific page. The value of the page parameter, if specified, has to be a value greater than zero. If the value of the page parameter exceeds the highest available page on the backend, an empty page is returned.	query	Optional
page-size	integer	The page size which defines the requested number of result entries. You can request a maximum of 1000 result entries. If this parameter is omitted, the default value of 20 will be used.	query	Optional
admin-access	boolean	Indicates whether the operation should be performed with elevated permissions - additionally requires document:documents:admin. If provided, the user effectively operates as owner of all documents. This isn't supported for ready-made documents.	query	Optional

Response

Response codes

Code	Description
200	-
401	-
403	-
500	-
503	-
default	-

GET

SaaS

https://{your-environment-id}.apps.dynatrace.com/platform/document/v1/trash/documents

Parameters

Parameter	Type	Description	In	Required
filter	string	The filter parameter, as explained here. If this parameter is omitted, no filtering is applied and all your deleted documents will be returned. Filtering by string type parameters when using one of the operators `contains`, `starts-with` and `ends-with` is case insensitive. Filtering by `id` using the operators `contains`, `starts-with` and `ends-with` is only supported in case of user-given document ids. When using the equals operator or the not-equals operator, filtering is case sensitive. The following fields are legal filtering parameters - any other field names will result in a HTTP 400 response: `id`, `name`, `type`, `deletionInfo.deletedTime`, `deletionInfo.deletedBy` The following constraints apply: Parameter names are case-sensitive. Maximum nesting depth (via brackets) is 3. Maximum length is 1024 characters.	query	Optional
page-key	string	The page key is used to query results from the next page. You get a `nextPageKey` parameter in the return value of this method to use here. If this parameter is omitted, the first page will be returned.	query	Optional
page	integer	The page parameter is used to directly access a specific page. The value of the page parameter, if specified, has to be a value greater than zero. If the value of the page parameter exceeds the highest available page on the backend, an empty page is returned.	query	Optional
page-size	integer	The page size which defines the requested number of result entries. You can request a maximum of 1000 result entries. If this parameter is omitted, the default value of 20 will be used.	query	Optional
admin-access	boolean	Indicates whether the operation should be performed with elevated permissions - additionally requires document:documents:admin. If provided, the user effectively operates as owner of all documents. This isn't supported for ready-made documents.	query	Optional

Code

Description

200

401

403

500

503

default