Skip to main content
POST
Create secret

Authorizations

Authorization
string
header
required

API key (dh_live_...) or Auth0 JWT token

Headers

Idempotency-Key
string

Replays the stored response for 24h when the same key is sent again (1–255 visible ASCII)

X-DevHelm-Client
string

Calling surface and version, e.g. cli/1.4.0 or sdk-js/2.0.0

Body

application/json
key
string
required

Unique secret key within the workspace (max 255 chars)

Maximum string length: 255
value
string
required

Secret value, stored encrypted (max 32KB)

Maximum string length: 32768
environmentId
string<uuid> | null

Environment to receive this value when creating the secret

Response

Created

data
object
required

Organization secret and its change-detection hash