Skip to main content
POST
Purge from Trash
Removes items from the trash for good, now, and frees the storage they used. It cannot be undone: nothing purged can be restored. MCP: trash_purge. CLI: rip trash purge. Send one entry, or all: true to empty a whole trash. Each item needs the same authority as deleting it (Restore from Trash lists who that is). Auth: Authorization: Bearer tr_...

Body

Response

With all, the purge takes what was in the trash when the first call began (or at deletedBefore, when earlier); anything deleted later stays. Each call handles at most TRASH_PURGE_PER_CALL entries (100 by default). A workspace file or folder purge records artifact.purged or folder.purged in the workspace change feed.

Errors