Sign in

v2

latestOpenAPI 3.1.02026-08-0382170235.8 KB
documents

Delete a document and its files

Delete a document and its files from storage.

By default (cascade=true) also deletes all facts extracted from this document across all POTs in the workspace, removes their edges and embeddings, and recalculates POT scores on affected neighbor facts.

BREAKING (v0.4.6): the default flipped from cascade=false to cascade=true so the erasure semantics match the published retention policy — deleting a source document must not leave derived knowledge behind. Integrators that relied on the old default must pass cascade=false explicitly.

delete/documents/{document_id}

Path parameters

document_idstring uuid required

Query parameters

cascadeboolean

Cascade delete facts, edges, embeddings and recalculate scores. Default true since v0.4.6 (retention policy): deleting a document erases the knowledge derived from it. Pass cascade=false to keep extracted facts (metadata + files only).

Cascade delete facts, edges, embeddings and recalculate scores. Default true since v0.4.6 (retention policy): deleting a document erases the knowledge derived from it. Pass cascade=false to keep extracted facts (metadata + files only).

Response

Document deleted with cascade (returns DeletionResult)

{"stackTrail":"paths:/documents/{document_id}:delete:responses:200:content:application/json:schema","oasType":"schema","type":"unknown"}