Move, trash or restore documents and folders

The way to trash, restore and bulk-move documents (there is no DELETE on a document): up to 500 ids in total across document_ids and folder_ids, one action: move, trash, restore or delete. Each item is applied on its own and what cannot be done is listed in skipped with a reason (not found, retained, name taken, folder moved into itself, not in the Trash); the call still answers 200. Trashing keeps an item for 30 days and is reversible with restore; a document linked to an issued invoice or a booked or void expense is a business record kept 10 years and cannot be trashed (skipped: retained). 422 validation_failed for an empty or oversized selection or an unknown action. delete removes items that are already in the Trash for good (owner or admin; anything else is skipped: not in the Trash); it cannot be undone, so trash first and delete only on an explicit request. Trashing the same items again is safe.