Set a secret value

​

Sets a runtime secret for your deployed config. The value is injected into your config's runtime environment; only the secret's name and timestamps are stored in the control plane — the value itself is never persisted there and is never listed by GET /v1/secrets.

Path Parameters

  • name
    Type: string
    required

    The secret name. Arbitrary string; your config references it by name.

Body·

required
application/json
  • value
    Type: string
    required

    The secret value. Injected into your config's runtime; never stored in the control plane beyond its name.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
Request Example for put/v1/secrets/{name}
curl https://api.useportal.co/v1/secrets/STRIPE_API_KEY \
  --request PUT \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "value": "sk_live_abc123..."
}'

{}

Secret stored.