Delete one or more vectors from a DashVector collection by ID. You can use the console, SDKs, or the HTTP API.
Deletion is permanent and cannot be undone. Verify the vector IDs before you proceed.
Prerequisites
Before you begin, make sure that you have:
A DashVector cluster with at least one collection that contains vectors
The primary key IDs of the vectors to delete
(Optional) The target partition name, if the vectors are stored outside the
defaultpartition
Delete vectors in the console
Log on to the DashVector console.
In the left-side navigation pane, click Clusters. Find the target collection and click Details in the Operation column.
In the left-side bar, click Vector Delete.
Configure the following parameters and click OK.
Parameters
| Parameter | API field | Required | Description |
|---|---|---|---|
| Primary Key ID | ids |
Yes | The primary key IDs of the vectors to delete. To delete multiple vectors, separate IDs with commas (,). All specified vectors must belong to the same partition. |
| Partition | partition |
Yes | The partition that contains the target vectors. Default value: default. |
If any specified ID does not exist in the partition, the delete operation for that vector is invalid. In batch deletion, vectors with matching IDs are deleted, and those with non-existent IDs are filtered out.
Response parameters
| Parameter | Type | Description | Example |
|---|---|---|---|
| Code | int | The returned status code. For details, see Status codes. | 0 |
| Message | str | Error message. Returned only when the request fails. | "5 does not exist." |
| RequestId | str | Unique request ID for troubleshooting. | 7730ABE1-DF1D-1F42-AAA1-607416AEED01 |
| Success | str | Whether the request succeeded. | true |
Delete vectors with SDKs
For complete code examples and API details, see the SDK-specific documentation:
Python: Delete documents
Java: Delete documents
Delete vectors with the HTTP API
For more information, see Delete documents.
Behavior and limits
| Behavior | Description |
|---|---|
| Non-existent IDs | If a specified ID does not exist, the delete operation for that vector is invalid. In batch deletion, vectors with matching IDs are deleted, and those with non-existent IDs are filtered out. |
| Partition scope | All IDs in a single delete request must belong to the same partition. |
| Default partition | If you do not specify a partition, the default partition is used. |
| Irreversibility | Deleted vectors cannot be recovered. |