Which Version is my Vault KV Mount?

Troubleshooting

Problem

Introduction

Overview

Newer versions of Vault allow you directly determine the version of a KV Secrets Engine mount by querying `/sys/mounts/:path/tune`, then extracting the "options" and "version" key from the data.

Procedures

Using `jq`, and given mounts named "example-one" and "example-two", a KV v1/v2 mounts will look like the following when queried via `/sys/mounts`:

$ vault read -format=json /sys/mounts/example-one/tune | \
    jq -r '.data.options.version'
1
$ vault read -format=json /sys/mounts/example-two/tune | \
    jq -r '.data.options.version'
2

Using `curl`,

$ curl -s -H "X-Vault-Token: $VAULT_TOKEN" \
    $VAULT_ADDR/v1/sys/mounts/example-one/tune | \
    jq -r '.data.options.version'
1
$ curl -s -H "X-Vault-Token: $VAULT_TOKEN" \
    $VAULT_ADDR/v1/sys/mounts/example-two/tune | \
    jq -r '.data.options.version'
2

Additional Information:

Vault `/sys/mounts` API, Reading Mount Configuration

Document Location

Worldwide

[{"Type":"MASTER","Line of Business":{"code":"LOB77","label":"Automation Platform"},"Business Unit":{"code":"BU048","label":"IBM Software"},"Product":{"code":"SSLC9Y2","label":"IBM Vault Self-Managed"},"ARM Category":[{"code":"a8mgJ0000000E4fQAE","label":"Vault-\u003ESecret Engine"}],"ARM Case Number":"","Platform":[{"code":"PF025","label":"Platform Independent"}],"Version":"1.14.10;1.14.11;1.14.12;1.14.13;1.14.8;1.14.9;1.15.0;1.15.1;1.15.10;1.15.11;1.15.12;1.15.13;1.15.14;1.15.15;1.15.16;1.15.2;1.15.3;1.15.4;1.15.5;1.15.6;1.15.7;1.15.8;1.15.9;1.16.0;1.16.1;1.16.10;1.16.11;1.16.12;1.16.13;1.16.14;1.16.15;1.16.16;1.16.17;1.16.18;1.16.19;1.16.2;1.16.20;1.16.21;1.16.22;1.16.23;1.16.24;1.16.25;1.16.26;1.16.27;1.16.28;1.16.29;1.16.3;1.16.30;1.16.31;1.16.4;1.16.5;1.16.6;1.16.7;1.16.8;1.16.9;1.17.0;1.17.1;1.17.10;1.17.11;1.17.12;1.17.13;1.17.14;1.17.15;1.17.16;1.17.17;1.17.18;1.17.2;1.17.3;1.17.4;1.17.5;1.17.6;1.17.7;1.17.8;1.17.9;1.18.0;1.18.1;1.18.10;1.18.11;1.18.12;1.18.13;1.18.14;1.18.15;1.18.2;1.18.3;1.18.4;1.18.5;1.18.6;1.18.7;1.18.8;1.18.9;1.19.0;1.19.1;1.19.10;1.19.11;1.19.12;1.19.13;1.19.14;1.19.15;1.19.16;1.19.17;1.19.18;1.19.2;1.19.3;1.19.4;1.19.5;1.19.6;1.19.7;1.19.8;1.19.9;1.20.0;1.20.1;1.20.10;1.20.11;1.20.12;1.20.2;1.20.3;1.20.4;1.20.5;1.20.6;1.20.7;1.20.8;1.20.9;1.21.0;1.21.1;1.21.2;1.21.3;1.21.4;1.21.5;1.21.6;1.21.7;2.0.0;2.0.1;2.0.2;4.2.0-5.4.0"}]

Historical Number

4404288741139

Was this topic helpful?

Document Information

Modified date:
16 June 2026

UID

ibm17264811

Tips