For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Contact usJoin the Discord
ManualAPI GuideAPI Reference
  • Overview
    • API Reference
    • Client libraries
  • API Reference
      • POSTIngest Content
      • POSTIngest Content Asynchronously
      • GETCheck Ingestion Task Status
      • GETList Ingested Documents
      • POSTDelete Ingested Document
      • POSTDelete Document Asynchronously
      • GETCheck Deletion Task Status
      • POSTRetrieve Full Document Content
      • POSTRetrieve Full Document Content in Chunks
LogoLogo
Contact usJoin the Discord
API ReferenceArtifacts

Delete Document Asynchronously

POST
https://host.com/v1/artifacts/delete/async
POST
/v1/artifacts/delete/async
$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"
>    }
>  }
>}'
1{
2  "task_id": "task_id"
3}
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.
Was this page helpful?
Previous

Check Deletion Task Status

Next
Built with

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