Skip to content

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

docs(guides): list bulk Trash endpoints and MCP tools (#3754)

mintlify[bot]aafaf6c4d7c0
diff --git a/docs/guides/using-the-api.mdx b/docs/guides/using-the-api.mdx
index c2d072701..5e6edb682 100644
--- a/docs/guides/using-the-api.mdx
+++ b/docs/guides/using-the-api.mdx
@@ -138,7 +138,7 @@ Every endpoint, with its parameters, request body and responses, is listed in th
| ------------- | --------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Resumes | `/resumes`, `/resumes/{id}` | List, read, create, import, update, patch, lock, duplicate, move to Trash, set a sharing password, download a PDF, read version history and statistics |
| Cover letters | `/cover-letters` | List, read, create, update, duplicate, export and import letters, restore versions, refresh their design from a resume |
-| Documents | `/documents` | Work across resumes and letters: rename, tag, lock, link to an application, move to Trash, restore, delete now |
+| Documents | `/documents` | Work across resumes and letters: rename, tag, lock, link to an application, move to Trash, restore or delete selected documents, empty Trash |
| Applications | `/applications` | Track job applications: stages, notes, interviews, attached PDFs, bulk changes, import, statistics |
| AI | `/ai-providers`, `/ai`, `/agent` | Manage your AI providers, run AI tools such as resume import from PDF, work with assistant conversations |
| Account | `/auth/account/export`, `/auth/account` | Export your account data, delete your account |
diff --git a/docs/guides/using-the-mcp-server.mdx b/docs/guides/using-the-mcp-server.mdx
index 19db9ef17..48dcc54da 100644
--- a/docs/guides/using-the-mcp-server.mdx
+++ b/docs/guides/using-the-mcp-server.mdx
@@ -250,6 +250,8 @@ Lists default to 20 results and accept `limit` (up to 100) and `offset`; continu
Document listing never deletes expired Trash. Run `api_documents_purge_expired` explicitly to permanently remove documents trashed more than 30 days ago. Individual permanent deletion requires moving the document to Trash first.
+To act on several trashed documents in one call, use `api_documents_restore_many` or `api_documents_purge_many` with up to 5,000 documents. Both skip documents that are active, already deleted or owned by another account. `api_documents_empty_trash` permanently deletes every document in your Trash, not only the ones you listed.
+
### File limits and references
The Streamable HTTP JSON request limit is 4 MiB. Inline base64 is limited to 3 MiB of encoded text (approximately 2.25 MiB of file bytes), leaving space for JSON metadata. Larger files use an owned `storagePath` returned by the REST file upload or assistant attachment endpoint: