Delete vectors in bulk

POST /v1/tenants/{tenant}/vector/{table}/delete-bulk

Remove a selected set of vectorsDuplicate input IDs count once in the outcome.

Choose up to 10,000 IDsSelect the collection and index type.
Delete the listed vectorsRemove only the specified vector identifiers.
Compare deleted and missing countsAccount for duplicates when reconciling totals.

Before you start

Use your database bearer token.

Choose the collection, index type and vector IDs to remove. The example deletes only its listed IDs.

Path parameters

Field	Type	Required
`tenant`	`string`	Required
`table`	`string`	Required

Headers

Field	Type	Required	Description
`x-oc-db-user`	`string`	Optional	Acting database user (role, grant and row-policy checks). Send with x-oc-db-key.
`x-oc-db-key`	`string`	Optional	API key of the x-oc-db-user user.

Request body

application/json

Limits and accepted values

ids: at most 10,000, each non-empty and at most 1024 bytes;
duplicates count once.
index: hnsw (default) | ivf | ivf_pq.
repair (HNSW only, default false) runs one graph-repair sweep after the batch.

Field	Type	Required
`ids`	`string[]`	Required

Fields in ids

Field	Type	Required
`ids`	`string`	Optional

Field	Type	Required
`index`	`string`	Optional
`repair`	`boolean`	Optional

Read the result

deleted_count and missing_count distinguish removed vectors from absent IDs. Duplicate input IDs count once, so totals need not equal the length of an input list containing duplicates.

Response statuses

HTTP status reference

Status	What to do
200	OK
400	Correct the request before retrying.
401	Check the credential and Authorization header.
402	Check feature access or available credits.
403	Check tenant access, roles and permissions.
409	Resolve the conflict before retrying.
413	Split or reduce the request body.
415	Send the required Content-Type.
422	Correct the values or unsupported combination.
429	Honor Retry-After when present; back off.
503	Honor Retry-After when present; check write outcomes.

Request example

curl --include --request POST "${OC_BASE_URL}/v1/tenants/${OC_TENANT}/vector/demo_vectors/delete-bulk" \
  --header "Authorization: Bearer ${OC_TOKEN}" \
  --header "Content-Type: application/json" \
  --data-binary '{
  "ids": [
    "v1",
    "v2"
  ],
  "index": "hnsw"
}'

Response example

Examples use synthetic values to show the response format.

Response status

{
  "deleted_count": 2,
  "missing_count": 0
}

Download the OpenAPI specification for the complete response schemas.

Before you startCopy Anchor Link

Path parametersCopy Anchor Link

HeadersCopy Anchor Link

Request bodyCopy Anchor Link