Search the docs

Search guides, API endpoints and MCP tools.

Vault

list_secret_versions

Read grantRead-onlyIdempotent

List a secret's versions in one environment, newest first, 100 at a time: each version's number, whether it holds a value, who wrote it and when. Never a value. Needs read access.

Inputs

productstringRequired

The product's slug, such as storefront.

namestringRequired

The secret's name, such as DATABASE_URL.

environmentstringRequired

The environment's slug, such as staging.

beforeinteger

Only versions numbered below this one, for the next page.

From -9,007,199,254,740,991 to 9,007,199,254,740,991
tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "list_secret_versions",    "arguments": {      "product": "storefront",      "name": "DATABASE_URL",      "environment": "staging"    }  }}
POST/clanker/v1/secrets:list-versions
curl -X POST https://api.clankership.com/clanker/v1/secrets:list-versions \  -H "Authorization: Bearer $CLANKER_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "product": "storefront",    "name": "DATABASE_URL",    "environment": "staging"  }'
The same call over the clanker HTTP API. Set CLANKER_TOKEN to a clanker OAuth access token.