Returns retained full-document history rows for a JSON document, newest first, including delete tombstones. A document with no retained history maps to an optional-read result.

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 document that never existed has no history.

CLI

$ strata json history absent

Wire

{"key":"absent","type":"json_history"}

Parameters

Name	Type	Required	Description
key	string	yes	Document key.

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

Returns

Maybe<Vec<JsonHistoryItem>> — 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.json_document_id

Invocation

• CLI: strata json history
• Wire type: json_history