documents.delete
documents.delete(id: str) -> None Soft-delete a stored document. Re-delete surfaces as 410 GONE.
Parameters
Section titled “Parameters”| Name | Type | Required | Description |
|---|---|---|---|
id | str | required | The `document_id` of the stored document to delete. |
Returns
Section titled “Returns”None — None. The PDF is purged; metadata is retained for audit.
Errors
Section titled “Errors”| Code | When |
|---|---|
DOCUMENT_NOT_FOUND | No stored document matches the supplied id. |
GONE | Document was already deleted. |
INTERNAL_ERROR | The API returned 5xx. Retryable. |
Example
Section titled “Example”# Demonstrates: client.documents.delete(id) — soft-delete a stored document.from poli_page import PoliPage
client = PoliPage()
client.documents.delete("doc_abc123")
# Returns None. The PDF is purged; metadata is retained for audit.print("Deleted.")