/sys/version-history

The /sys/version-history endpoint is used to retrieve the version history of an OpenBao instance.

Read version history

This endpoint returns the version history of the OpenBao. The response will contain the following keys:

• keys: a list of installed versions in chronological order based on the time installed
• key_info: a map indexed by the versions found in the keys list containing the following subkeys:
  • build_date: the time (in UTC) at which the OpenBao binary used to run the OpenBao server was built.
  • previous_version: the version installed prior to this version or null if no prior version exists
  • timestamp_installed: the time (in UTC) at which the version was installed

Method	Path
LIST	/sys/version-history

Sample request

$ curl \
    -X LIST --header "X-Vault-Token: ..." \
    http://127.0.0.1:8200/v1/sys/version-history

Sample response

{
  "keys": ["1.9.0", "1.9.1", "1.9.2", "1.11.0"],
  "key_info": {
    "1.9.0": {
      "build_date": null,
      "previous_version": null,
      "timestamp_installed": "2021-11-18T10:23:16Z"
    },
    "1.9.1": {
      "build_date": null,
      "previous_version": "1.9.0",
      "timestamp_installed": "2021-12-13T11:09:52Z"
    },
    "1.9.2": {
      "build_date": null,
      "previous_version": "1.9.1",
      "timestamp_installed": "2021-12-23T10:56:37Z"
    },
    "1.11.0": {
      "build_date": "2022-05-03T08:34:11Z",
      "previous_version": null,
      "timestamp_installed": "2022-05-03T13:16:04Z"
    }
  }
}