--- title: "List all deleted documents" method: POST path: "/documents.deleted" tags: ["Documents"] --- # List all deleted documents `POST /documents.deleted` ## Request - Base URL: `https://app.getoutline.com/api` - URL: `https://app.getoutline.com/api/documents.deleted` - Auth: one of: - HTTP bearer - OAuth 2 - Authorization code: `https://app.getoutline.com/oauth/authorize` - Token URL: `https://app.getoutline.com/oauth/token` scopes: `read`, `write` This method will list all deleted documents belonging to the workspace that the current user has access to. ## Request body - object - `offset` number - `limit` number - `sort` string - `direction` 'ASC' | 'DESC' - `filters` DocumentsDeletedFilter[]: Structured filter expression, evaluated as an AND of top-level entries. Supported fields are `deletedAt` (date) and `deletedById` (uuid, identifier of the user who deleted the document). - union: A single filter node for `/documents.deleted`, either a leaf condition matching a supported field or a group combining nested filters with a logical operator. - object: A condition that compares a deleted-document field against a value. - `field` 'deletedAt' | 'deletedById', required: Name of the field to filter on. - `operator` 'eq' | 'neq' | 'lt' | 'lte' | 'gt' | 'gte' | 'in' | 'notIn' | 'isNull' | 'isNotNull', required: Comparison operator to apply. `deletedById` only supports `eq` and `in`. - `value` unknown - object: A logical group that combines nested filters with an `AND` or `OR` operator. Groups may themselves contain further groups. - `operator` 'AND' | 'OR', required - `filters` DocumentsDeletedFilter[], required ## Response `200` OK - object - `data` Document[] - `id` string, uuid: Unique identifier for the object. - `collectionId` string, uuid, nullable: Identifier for the associated collection. - `parentDocumentId` string, uuid, nullable: Identifier for the document this is a child of, if any. - `title` string: The title of the document. - `fullWidth` boolean: Whether this document should be displayed in a full-width view. - `icon` string, nullable: An emoji or icon associated with the document. - `color` string, nullable: The color of the document icon in hex format. - `text` string: The text content of the document, contains markdown formatting - `data` object, nullable: The body of the document as a Prosemirror document, returned in place of text when requested. - `url` string: A URL path to access the document. Deprecated – prefer the `path` field. - `path` string: A URL path to access the document. - `urlId` string: A short unique ID that can be used to identify the document as an alternative to the UUID - `collaboratorIds` string[]: Identifiers of users who have edited the document. - `tasks` object: Task completion counts for the document. - `completed` number - `total` number - `templateId` string, uuid: Unique identifier for the template this document was created from, if any - `revision` number: A number that is auto incrementing with every revision of the document that is saved - `createdAt` string, date-time: The date and time that this object was created - `createdBy` User - `id` string, uuid: Unique identifier for the object. - `name` string: The name of this user, it is migrated from Slack or Google Workspace when the SSO connection is made but can be changed if necessary. - `avatarUrl` string, uri: The URL for the image associated with this user, it will be displayed in the application UI and email notifications. - `color` string: A color representing the user, used in the UI for avatars without an image. - `email` string, email: The email associated with this user, it is migrated from Slack or Google Workspace when the SSO connection is made but can be changed if necessary. - `role` 'admin' | 'member' | 'viewer' | 'guest' - `isSuspended` boolean: Whether this user has been suspended. - `lastActiveAt` string, date-time, nullable: The last time this user made an API request, this value is updated at most every 5 minutes. - `timezone` string, nullable: The timezone this user has registered. - `createdAt` string, date-time: The date and time that this user first signed in or was invited as a guest. - `updatedAt` string, date-time: The date and time that this user was last updated. - `deletedAt` string, date-time, nullable: The date and time that this user was deleted, if applicable. - `invitedBy` User (recursive) - `updatedAt` string, date-time: The date and time that this object was last changed - `updatedBy` User - `id` string, uuid: Unique identifier for the object. - `name` string: The name of this user, it is migrated from Slack or Google Workspace when the SSO connection is made but can be changed if necessary. - `avatarUrl` string, uri: The URL for the image associated with this user, it will be displayed in the application UI and email notifications. - `color` string: A color representing the user, used in the UI for avatars without an image. - `email` string, email: The email associated with this user, it is migrated from Slack or Google Workspace when the SSO connection is made but can be changed if necessary. - `role` 'admin' | 'member' | 'viewer' | 'guest' - `isSuspended` boolean: Whether this user has been suspended. - `lastActiveAt` string, date-time, nullable: The last time this user made an API request, this value is updated at most every 5 minutes. - `timezone` string, nullable: The timezone this user has registered. - `createdAt` string, date-time: The date and time that this user first signed in or was invited as a guest. - `updatedAt` string, date-time: The date and time that this user was last updated. - `deletedAt` string, date-time, nullable: The date and time that this user was deleted, if applicable. - `invitedBy` User (recursive) - `publishedAt` string, date-time, nullable: The date and time that this object was published - `dataAttributes` DocumentDataAttribute[], nullable - `dataAttributeId` string, uuid: Unique identifier for the associated data attribute. - `value` union: The value of the data attribute for this document. - string - boolean - number - `updatedAt` string, date-time: The date and time that this object attribute was last changed - `archivedAt` string, date-time, nullable: The date and time that this object was archived - `deletedAt` string, date-time, nullable: The date and time that this object was deleted - `deletedBy` User - `id` string, uuid: Unique identifier for the object. - `name` string: The name of this user, it is migrated from Slack or Google Workspace when the SSO connection is made but can be changed if necessary. - `avatarUrl` string, uri: The URL for the image associated with this user, it will be displayed in the application UI and email notifications. - `color` string: A color representing the user, used in the UI for avatars without an image. - `email` string, email: The email associated with this user, it is migrated from Slack or Google Workspace when the SSO connection is made but can be changed if necessary. - `role` 'admin' | 'member' | 'viewer' | 'guest' - `isSuspended` boolean: Whether this user has been suspended. - `lastActiveAt` string, date-time, nullable: The last time this user made an API request, this value is updated at most every 5 minutes. - `timezone` string, nullable: The timezone this user has registered. - `createdAt` string, date-time: The date and time that this user first signed in or was invited as a guest. - `updatedAt` string, date-time: The date and time that this user was last updated. - `deletedAt` string, date-time, nullable: The date and time that this user was deleted, if applicable. - `invitedBy` User (recursive) - `deprecatedReason` string, nullable: The reason the document was archived or deleted, if one was provided. - `preferences` object, nullable: Document-level display preferences. - `headingPrefix` 'none' | 'numeric' | 'alphanumeric' | 'outline': Numbering style applied to the document's headings when rendered. - `policies` Policy[] - `id` string, uuid: Unique identifier for the object this policy references. - `abilities` object: The abilities that are allowed by this policy, if an array is returned then the individual ID's in the array represent the memberships that grant the ability. - `pagination` Pagination - `offset` number - `limit` number ## Other responses - `401`: The API key is missing or otherwise invalid. - `403`: The current API key is not authorized to perform this action. - `429`: The request was rate limited. ## Changes - **2026-11-02** `5ddf01ffba84`: 2 info - added the optional property `data/items/path` to the response with the `200` status - response property `data/items/url` deprecated - **2026-09-20** `a75820943fbb`: 1 info - added the optional property `data/items/deprecatedReason` to the response with the `200` status - **2026-08-24** `dff00215628f`: 2 info - added the optional property `data/items/deletedBy` to the response with the `200` status - added the optional property `data/items/preferences` to the response with the `200` status - **2026-08-19** `3dd8bbf9150d`: 1 breaking - added `subschema #3` to the request body `allOf` list - **2026-08-12** `9a99ee93e11d`: 2 info - added the optional property `data/items/createdBy/invitedBy` to the response with the `200` status - added the optional property `data/items/updatedBy/invitedBy` to the response with the `200` status [Operation history](https://skmtc.dev/defaulr/apis/outline-api/changes/documents.deleted/post.md) --- [API](https://skmtc.dev/defaulr/apis/outline-api.md) - [All operations](https://skmtc.dev/defaulr/apis/outline-api/llms.txt) - [OpenAPI document](https://skmtc.dev/defaulr/apis/outline-api/revisions/5ddf01ffba84?raw)