Creating a secret

Console
API
CLI
Go

Go to Secrets and choose Create Secret. Under Secret details give it a Name and an optional Description, paste the first Value, and leave Encryption key on Platform-managed key (default) unless you want one of your own keys.The console takes the value as text and base64-encodes it for you; over the API you encode it yourself.

POST https://secrets.sa-saopaulo-1.basaltic.sh/v1/secrets
{
  "name": "prod/api/stripe-key",
  "value": "c3VwZXItc2VjcmV0LXZhbHVl",
  "description": "Stripe live secret key for the payments service"
}

basaltic secrets create \
  --name prod/api/stripe-key \
  --value "$(base64 -w0 <<< 'super-secret-value')" \
  --description "Stripe live secret key for the payments service"

cfg, err := basaltic.NewConfig(ctx,
    basaltic.WithClientCredentials(os.Getenv("BASALTIC_ACCESS_KEY_ID"), os.Getenv("BASALTIC_SECRET_ACCESS_KEY")),
    basaltic.WithRegion("sa-saopaulo-1"),
)
if err != nil {
    log.Fatal(err)
}

sec, err := secrets.New(cfg).CreateSecret(ctx, &secrets.CreateSecretRequest{
    Name:        "prod/api/stripe-key",
    Value:       []byte("super-secret-value"),
    Description: basaltic.String("Stripe live secret key for the payments service"),
})

Value is raw bytes — the SDK base64-encodes it, so do not encode it yourself.

A secret is created with its first value — there is no such thing as an empty secret. The response is 201 and the secret is at version 1.

base64, 1 byte – 64 KiB

Values travel base64-encoded so arbitrary binary payloads survive JSON intact. Anything larger than 64 KiB belongs in a bucket, with the secret holding the reference and the credentials to fetch it — not crammed inline.

unique per account

Matches ^[a-zA-Z0-9][a-zA-Z0-9._/-]{0,255}$. Slashes are allowed, which is why prod/api/stripe-key works — and because the CRN is built from the name, a path convention becomes directly policy-able: crn:secrets:sa-saopaulo-1:my-account:secret/prod/*.

Get started

Products

Platform

Help

Creating a secret

Creating a secret

​Creating a secret

Creating a secret