Trash or permanently delete a folder
Soft-deletes a folder and everything under it (descendant folders + the
documents they hold travel to Trash together, like Drive/Dropbox). Restore
with POST /v1/api/folders/{id}/restore. Pass ?purge=true to permanently
delete an already-trashed folder: the subtree folders + their documents are
hard-deleted and each document’s bytes dropped from storage (dedup-guarded).
Private folders are owner-only; team/channel folders are deletable by any
member. Requires documents:write.
Authorizations
Personal Access Token. Send as Authorization: Bearer hq_pat_....
Path Parameters
Folder id
Query Parameters
When true, permanently delete (and drop the bytes when no other document shares them) instead of moving to Trash. This is "delete forever" / empty-trash; the default soft-deletes so it can be restored.
Response
Trashed (or purged with ?purge=true)