---
title: "Delete Document Asynchronously"
method: POST
path: "/v1/artifacts/delete/async"
tags: ["Artifacts", "Artifacts"]
---

# Delete Document Asynchronously

`POST /v1/artifacts/delete/async`

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 body

- DeleteIngestedDocumentAsyncBody — Request body for asynchronous document deletion.
  - `callback` Callback — Callback configuration for asynchronous task notifications.
    - `amqp` AMQP, required — AMQP configuration for message queue notifications.
      - `exchange` string, required — AMQP exchange name where task notifications will be published
      - `routing_key_done` string, nullable — Routing key used when publishing task completion notifications
      - `routing_key_progress` string, nullable — Routing key used when publishing task progress update notifications
      - `routing_key_error` string, nullable — Routing key used when publishing task error notifications
    - `properties` object, nullable — Additional properties and metadata to include with callback notifications
  - `delete_body` DeleteIngestedDocumentBody, required — Request body for deleting specific ingested documents from the system.
    - `collection` string, required — Name of the collection containing the document to be deleted
    - `artifact` string, required — Unique identifier of the document to delete from the specified collection

## Response `200`

Successfully initiated deletion task

- Task — Represents an asynchronous task that has been queued.
  - `task_id` string, required — Unique identifier for the asynchronous task, used to track progress and retrieve results

## Other responses

- `401` — Unauthorized
- `422` — Invalid request parameters

## Changes

- **2026-06-03** `7914e6f947be` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/zylon-ai/apis/private-gpt-api/changes/v1/artifacts/delete/async/post.md)

---

[API](https://skmtc.dev/zylon-ai/apis/private-gpt-api.md) · [All operations](https://skmtc.dev/zylon-ai/apis/private-gpt-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/zylon-ai/private-gpt-api/revisions/4e828cf153c4/schema)