---
title: "Delete Documents"
method: DELETE
path: "/knowledge/{knowledge_base_id}/query"
tags: ["knowledge"]
---

# Delete Documents

`DELETE /knowledge/{knowledge_base_id}/query`

Delete documents from a knowledge base based on filters

## Path parameters

- `knowledge_base_id` string, uuid, required — The id of the knowledge base to delete or delete documents from

## Request body

- DeleteKnowledgeBaseRequest
  - `filters` Filter[], nullable — Filters to apply for deletion. If no filters are provided, the entire knowledge base will be deleted.
    - `field` string, required — The field to filter on
    - `operation` '=' | '!=' | '>' | '<' | 'in', required
    - `value` union, required — The value to filter on
      - string
      - integer
      - number
      - union[]
        - union
          - string
          - integer
          - number

## Response `200`

The number of documents deleted is returned

- DeleteKnowledgeBaseResponse
  - `deleted_count` integer, required — The number of documents deleted

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `402` — Payment Required (out of credits)
- `404` — Not Found
- `422` — Request Validation Error

---

[API](https://skmtc.dev/opper/apis/opper-api-v2.md) · [All operations](https://skmtc.dev/opper/apis/opper-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/opper/opper-api-v2/revisions/d3ccdaa15678/schema)