batch_move_documents
DestructiveIdempotent
Move multiple documents to a different collection or parent while preserving child hierarchies. Bulk reorganize and restructure document collections.
Instructions
Moves multiple documents to a different collection or parent.
This tool processes each document sequentially, continuing even if
individual operations fail. Rate limiting is handled automatically.
IMPORTANT: When moving documents that have child documents, all
children will move along with them, maintaining hierarchical
structure. You must specify either collection_id or
parent_document_id (or both).
Use this tool when you need to:
- Reorganize multiple documents at once
- Move documents between collections in bulk
- Restructure document hierarchies efficiently
Recommended batch size: 10-50 documents per operation
Args:
document_ids: List of document IDs to move
collection_id: Target collection ID (optional)
parent_document_id: Target parent document ID (optional)
Returns:
Summary of batch operation with success/failure details
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| document_ids | Yes | ||
| collection_id | No | ||
| parent_document_id | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |