json
history
Read retained version history for one JSON document.
strata json historydb.json.history(key: 'str') -> 'Optional[list]'wire json_history
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.
To see the complete help for this command, run:
strata json history --helphelp(db.json.history)
Example
A document that never existed has no history.
strata json history absentdb.json.history("absent") is NoneParameters
| Name | Type | Required | Description |
|---|---|---|---|
| key | string | yes | Document key. |
| branch | string or null | no | Target branch. Defaults to the executor handle branch. |
| space | string or null | no | Target product space. Defaults to `"default"`. |
Returns
Maybe<Vec<JsonHistoryItem>>
- dataarray or null
- typestring
Errors
Recover by code. Retry policy and commit outcome come from the shipped error registry.
| Code | Retry | Commit outcome |
|---|---|---|
| failed_precondition.engine.runtime_closed | never | not_started |
| not_found.engine.branch | never | not_applicable |
| invalid_argument.engine.product_space | never | not_started |
| invalid_argument.engine.json_document_id | never | not_started |