Documents

Delete Document

Remove a document from your database by its ID. This permanently deletes the document and its associated embeddings.

DELETE

/databases/{db_id}/documents/{doc_id}

Path Parameters

db_idstringrequired

The database ID

doc_idstringrequired

The document ID to delete

Response

Returns the deleted document with its metadata.

vector_idstring

Unique ID of the deleted document

contentstring | null

The document's text content (if applicable)

metadataobject | null

Associated metadata JSON object

created_atstring

ISO 8601 timestamp of when the document was created

Example response

{
  "vector_id": "4de5bed5-e483-4bd7-9760-a54ec07aefd9",
  "content": "How to fix a leaky kitchen faucet",
  "metadata": {
    "category": "home-repair"
  },
  "created_at": "2024-01-15T10:30:00Z"
}

Delete Multiple Documents

Delete up to 1,000 documents in a single request. IDs that don't exist are skipped, and the response lists the documents that were actually deleted.

DELETE

/databases/{id}/documents/batch

Request body

vector_idsstring[]required

Between 1 and 1,000 document IDs to delete

Example request

{
  "vector_ids": [
    "4de5bed5-e483-4bd7-9760-a54ec07aefd9",
    "9b1c2f7e-3a6d-4c1e-8f0a-2d5e7b9c1a34"
  ]
}

Response

countinteger

Number of documents deleted

vector_idsstring[]

IDs of the documents that were deleted

Example response

{
  "count": 2,
  "vector_ids": [
    "4de5bed5-e483-4bd7-9760-a54ec07aefd9",
    "9b1c2f7e-3a6d-4c1e-8f0a-2d5e7b9c1a34"
  ]
}