Deletes multiple vector keys and returns one positional mutation result per input key.

Itemwise batches return one positional item result per input item. The outer batch status summarizes whether all, some, or none of the items succeeded.

Examples

Delete many vectors in one commit.

CLI

$ strata vector collection create docs 3 cosine
$ strata command run --command-json '{"collection":"docs","entries":[{"key":"a","vector":[1.0,0.0,0.0]},{"key":"b","vector":[0.0,1.0,0.0]}],"type":"vector_batch_upsert"}'
$ strata command run --command-json '{"collection":"docs","keys":["a","b"],"type":"vector_batch_delete"}'
$ strata vector count docs

Wire

{"collection":"docs","dimension":3,"metric":"cosine","type":"vector_create_collection"}
{"collection":"docs","entries":[{"key":"a","vector":[1.0,0.0,0.0]},{"key":"b","vector":[0.0,1.0,0.0]}],"type":"vector_batch_upsert"}
{"collection":"docs","keys":["a","b"],"type":"vector_batch_delete"}
{"collection":"docs","type":"vector_count"}

Parameters

Name	Type	Required	Description
collection	string	yes	Collection name.
keys	string[]	yes	Keys to delete.

Plus the optional scope: branch and space (default to the session branch and the "default" space).

Returns

BatchResult<VectorMutationItem>.

Errors

• failed_precondition.engine.runtime_closed
• not_found.engine.branch
• invalid_argument.engine.product_space
• invalid_argument.engine.vector_collection
• invalid_argument.engine.vector_key
• not_found.engine.vector_collection
• invalid_argument.engine.vector_batch
• invalid_argument.executor.vector_batch_duplicate_key

Invocation

• CLI: via strata command run (no dedicated verb)
• Wire type: vector_batch_delete