Search the docs

Search guides, API endpoints and MCP tools.

Vault

create_secret

Write grant

Define a secret's name on a product, with no value yet; people set values on the website or with the CLI, or generate_secret makes one. Returns the secret with each environment's version, never a value. Needs write access; viewers cannot.

Inputs

productstringRequired

The product's slug, such as storefront.

namestringRequired

The secret's name, such as DATABASE_URL.

tools/callJSON-RPC
{  "jsonrpc": "2.0",  "id": 1,  "method": "tools/call",  "params": {    "name": "create_secret",    "arguments": {      "product": "storefront",      "name": "STRIPE_WEBHOOK_SECRET"    }  }}
POST/clanker/v1/secrets:create
curl -X POST https://api.clankership.com/clanker/v1/secrets:create \  -H "Authorization: Bearer $CLANKER_TOKEN" \  -H "Content-Type: application/json" \  -d '{    "product": "storefront",    "name": "STRIPE_WEBHOOK_SECRET"  }'
The same call over the clanker HTTP API. Set CLANKER_TOKEN to a clanker OAuth access token.