Delete Document Asynchronously | PrivateGPT

Initiates asynchronous deletion of a document and all associated data.

This endpoint queues a deletion task for background processing, making it suitable for large documents or when non-blocking operation is required. The task can be monitored using the returned task ID.

If an ingestion task is currently running for the same document, it will be automatically revoked before initiating the deletion.

Initiates asynchronous deletion of a document and all associated data. This endpoint queues a deletion task for background processing, making it suitable for large documents or when non-blocking operation is required. The task can be monitored using the returned task ID. If an ingestion task is currently running for the same document, it will be automatically revoked before initiating the deletion.

Request

JSON request body containing deletion parameters and optional callback configuration for asynchronous processing notifications

delete_bodyobjectRequired

Document deletion parameters including collection and artifact identifiers

callbackobject or nullOptional

Optional callback configuration for receiving asynchronous task notifications

Response

Successfully initiated deletion task

task_idstring

Unique identifier for the asynchronous task, used to track progress and retrieve results

Errors

401

Unauthorized Error

422

Unprocessable Entity Error

$	curl -X POST /v1/artifacts/delete/async \
>	-H "Content-Type: application/json" \
>	-d '{
>	"delete_body": {
>	"collection": "financial_reports",
>	"artifact": "obsolete_report_2022"
>	},
>	"callback": {
>	"amqp": {
>	"exchange": "deletion_events",
>	"routing_key_done": "delete.completed",
>	"routing_key_progress": "delete.progress",
>	"routing_key_error": "delete.failed"
>	}
>	}
>	}'