Returns retained history rows for one vector key, including vector revision facts and tombstones when present.

Optional reads distinguish present data from missing data. When version or timestamp facts exist on the executor output, SDK mappings should preserve them.

Examples

A key that never existed has no history.

CLI

$ strata vector collection create docs 3 cosine
$ strata vector history docs absent

Wire

{"collection":"docs","dimension":3,"metric":"cosine","type":"vector_create_collection"}
{"collection":"docs","key":"absent","type":"vector_history"}

Parameters

Name	Type	Required	Description
collection	string	yes	Collection name.
key	string	yes	Vector key.

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

Returns

Maybe<Vec<VectorHistoryItem>> — a miss returns nothing rather than raising.

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

Invocation

• CLI: strata vector history
• Wire type: vector_history