Skip to main content
DELETE
/
v1
/
collections
/
{collection_identifier}
/
documents
/
batch
Batch Delete Documents
curl --request DELETE \
  --url https://api.mixpeek.com/v1/collections/{collection_identifier}/documents/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "document_ids": [
    "doc_123",
    "doc_456",
    "doc_789"
  ],
  "filters": {
    "AND": [
      {
        "field": "metadata.status",
        "operator": "eq",
        "value": "archived"
      }
    ]
  }
}
'
{
  "deleted_count": 123,
  "failed_count": 0,
  "results": [
    {
      "document_id": "<string>",
      "success": true,
      "error": "<string>"
    }
  ],
  "message": "Batch delete completed"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
collection_identifier
string
required

The ID of the collection to delete documents from.

Body

application/json

Request model for batch deleting multiple documents by explicit IDs or filters.

Supports TWO modes:

  1. Explicit IDs mode: Provide 'document_ids' array
  2. Filter mode: Provide 'filters' to delete all matching documents

Use Cases: - Delete 5 specific documents in one API call - Delete all documents matching criteria - Bulk cleanup operations

Requirements: - EITHER 'document_ids' OR 'filters' must be provided - NOT BOTH modes simultaneously

​
document_ids
string[] | null

OPTIONAL. List of document IDs to delete. Use this mode when you know exact document IDs to delete. Mutually exclusive with filters mode. Maximum 1000 documents per batch request.

Required array length: 1 - 1000 elements
Example:
["doc_123", "doc_456", "doc_789"]
​
filters
LogicalOperator · object | null

OPTIONAL. Filter conditions to match documents for deletion. Mutually exclusive with 'document_ids' array. If provided, deletes ALL documents matching the filters. Use with caution - can delete many documents at once. Uses the logical AND/OR/NOT shape (not MVS-native must/key).

Example:
{
  "AND": [
    {
      "field": "metadata.status",
      "operator": "eq",
      "value": "archived"
    }
  ]
}

Response

Successful Response

Response model for batch document delete operation.

Provides detailed per-document results showing success/failure for each deletion.

​
deleted_count
integer
required

Total number of documents successfully deleted

​
failed_count
integer
default:0

Total number of documents that failed to delete

​
results
BatchDocumentDeleteResult · object[]

Detailed per-document results. Each entry shows document_id, success status, and error message (if failed). Empty list when using filter mode (only counts returned).

​
message
string
default:Batch delete completed

Summary message of the operation