Skip to main content
Deleting a check needs manage_documents, the same permission that gates verdict overrides. Reading and submitting are not enough: retracting a colleague’s result is a different level of trust from producing one.
A successful delete returns 204 with no body. The check disappears from the API immediately — a later GET on the same id is a 404, and it no longer appears in list.

​
What a plain delete does

Removes the check from your workspace. Watchdoc keeps the file and the analysis.

​
Permanently purge from Watchdoc

Pass purge=true to permanently delete the file and all analysis data from our systems:
This is irreversible. There is no recovery window and no support path to undo it. You can purge a check you already soft-deleted: DELETE ...?purge=true still works by id even though the check no longer shows in list or GET. The check id, its timestamps and its verdict survive so the run stays reconcilable against your invoice and your usage history. Purging does not refund a credit; the analysis already ran. If several checks share one uploaded document, the filename and hash are only cleared once the last of them has been purged.

​
Dashboard

In the dashboard the same choice is a checkbox labelled Permanently purge from Watchdoc. Ticking it swaps the confirm button to Purge permanently. On the documents list you can select multiple checks on the current page and delete or purge them together. Members with manage_documents can turn on Always purge from Watchdoc under Workspace settings. That only pre-ticks the dashboard checkbox. API deletes still need an explicit ?purge=true.