# Withdraw a document

> Takes a document out of every default read while keeping its history.

Takes a document out of every default read while keeping its history. The withdrawal is archived as a **tombstone version**, so one mechanism answers what a document holds now and there is no second lifecycle flag for a reader to miss.

Its chunks are dropped from the knowledge index, so a withdrawn document costs a live search nothing. The content is not lost with them: it is in the version before the tombstone, which [`POST /api/v1/documents/{document_id}/versions/{version}/restore`](/docs/api/documents/restore-document-version) re-chunks from.

`DELETE` stays what it is — permanent, and it removes the backing file. Withdrawal is the reversible act. It does not apply under `/.system/`: a platform-written document keeps the owning module's lifecycle.

  Request

<ParamsDetails
  {...require("./withdraw-document.ParamsDetails.json")}
>

<RequestSchema
  {...require("./withdraw-document.RequestSchema.json")}
>

<StatusCodes
  {...require("./withdraw-document.StatusCodes.json")}
>