Docs
Sign in

Search the docs

Search guides, API endpoints and MCP tools.

Vault

restore_secret_version

Write grantIdempotent

Restore an earlier version of a secret in one environment, as its newest version. Production needs an admin or owner. Returns the outcome without the value. Needs write 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.

versionintegerRequired

The version to restore, from list_secret_versions.

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": "restore_secret_version",    "arguments": {      "product": "storefront",      "name": "DATABASE_URL",      "environment": "staging",      "version": 3    }  }}
POST/clanker/v1/secrets:restore-version
curl -X POST https://api.clankership.com/clanker/v1/secrets:restore-version \  -H "Authorization: Bearer $CLANKER_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "product": "storefront",    "name": "DATABASE_URL",    "environment": "staging",    "version": 3  }'
The same call over the clanker HTTP API. Set CLANKER_TOKEN to a clanker OAuth access token.
Nextlist_vault_keys