Secrets API

The /v1/vaults/{vault_id}/secrets endpoints manage individual secrets. Each secret contains metadata, labels, and multiple versions.

Create a Secret

curl -X POST https://api.secryn.com/v1/vaults/vault_123/secrets \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "db_password",
    "value": "s3cr3t",
    "labels": {"service": "billing"}
  }'

Use the ?version= query parameter to retrieve historical values or ?state=draft to inspect pending rotations.