Delete Vectors

POST/v5/vector-stores/{vector_store_name}/delete

Delete documents from a vector store by document IDs or metadata filter criteria.

Delete by IDs: Provide an array of document IDs to delete specific documents. Non-existent documents are silently skipped.

Delete by Filter: Use metadata filters to delete all documents matching the specified criteria (e.g., delete all documents where status: "archived"). The filter must specify at least one condition and cannot be empty. To delete all documents, use the drop endpoint instead.

Filter Operators: Supports MongoDB-style operators including equality ({"field": "value"}), comparison ($gt, $gte, $lt, $lte, $eq, $ne), logical ($and, $or, $not), and membership ($in, $nin). Only indexed metadata fields can be used for filtering.

Best Practice: Use the count endpoint with the same filter to preview the number of documents that will be deleted before executing the deletion operation.

Path ParametersExpand Collapse

vector_store_name: string

The name of the vector store

Body ParametersJSONExpand Collapse

filter: optional map[unknown]

Metadata filter expression for deletion

ids: optional array of string

Array of document IDs to delete

ReturnsExpand Collapse

deleted_count: number

Number of documents deleted

Delete Vectors

curl https://api.egp.scale.com/v5/vector-stores/$VECTOR_STORE_NAME/delete \
    -H 'Content-Type: application/json' \
    -H "x-api-key: $SGP_API_KEY" \
    -d '{}'

{
  "deleted_count": 0
}

Returns Examples

{
  "deleted_count": 0
}