batch_delete_documents
DestructiveIdempotent
Delete multiple documents, moving to trash or permanently. Processes sequentially, continuing on failures. Use for bulk cleanup or permanent removal.
Instructions
Deletes multiple documents, moving them to trash or permanently.
This tool processes each document sequentially, continuing even if
individual operations fail. Rate limiting is handled automatically.
IMPORTANT: When permanent=False (the default), documents are moved
to trash and retained for 30 days. Setting permanent=True bypasses
trash and immediately deletes documents without recovery option.
Use this tool when you need to:
- Remove multiple unwanted documents at once
- Clean up workspace in bulk
- Permanently delete sensitive information (with permanent=True)
Recommended batch size: 10-50 documents per operation
Args:
document_ids: List of document IDs to delete
permanent: If True, permanently deletes without recovery option
Returns:
Summary of batch operation with success/failure details
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| permanent | No | ||
| document_ids | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |