Skip to main content
POST
Restore from Trash
Brings an item back from the trash, exactly as it was: the same folder, workspace, name, audience, pins and history. A folder or workspace brings back everything that went to the trash with it. MCP: trash_restore. CLI: rip trash restore <id>. Restoring needs the same authority as deleting: Auth: Authorization: Bearer tr_...

Body

Response

Restoring an item that is not in the trash does nothing and still answers restored: true. A workspace restore records workspace.restored, and a workspace artifact or folder restore records artifact.restored or folder.restored, in the workspace change feed.

Errors

Restore works until the item’s purgeAt (30 days after deletion; for an artifact in the trash with its folder, the folder’s date). After that the daily purge removes it for good. Purge from Trash removes it sooner. The operator dashboard restores through POST /v0/operator/trash/restore.