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

This endpoint expects an object.

delete_bodyobjectRequired

Document deletion parameters including collection and artifact identifiers

callbackobjectOptional

Optional callback configuration for receiving asynchronous task notifications

Response

This endpoint returns an object.

task_idstring

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

Errors

401

Unauthorized

422

Unprocessable Entity

$	curl -X POST https://host.com/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"
>	}
>	}
>	}'