Skip to main content

Delete Document

Permanently delete a document and all associated extractions. This action is irreversible and removes the original file and all extraction results.

Permanently delete a document along with its original file, extracted text, and all associated extraction results. This operation cannot be undone.

Deletion is irreversible. The original file, OCR output, and all extraction results are permanently removed. If the document is part of a case or entity group, its links are also removed.
DELETE/v1/documents/:id

Response

Response fields

deletedbooleanAlways true on success.
idstringID of the deleted document.

Response

{
  "deleted": true,
  "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}

Most integrations call this endpoint as part of a cleanup workflow after data has been exported or when a document was uploaded in error. A typical pattern is to list documents with GET /v1/documents, identify candidates for deletion, then call this endpoint for each one.

The response includes a deleted field set to true and the id of the removed document. There is no soft-delete mechanism — the original file, OCR markdown, and all extraction results are permanently purged from storage.

Pair this with GET /v1/documents/:id beforehand to verify you are deleting the correct resource. Note that if the document participated in entity linking or cases, those links are removed and affected cases may be recomputed during the next backfill cycle.

Errors

Error responses

401unauthorizedMissing or invalid API key.
404document_not_foundNo document with this ID exists for your organization.
429rate_limitedToo many requests. Retry after the period indicated in the Retry-After header.

Related

Get Document