Skip to main content
POST
Create environment

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
name
string
required

Human-readable environment name

Maximum string length: 100
slug
string
required

URL-safe identifier (lowercase alphanumeric, hyphens, underscores)

Maximum string length: 100
Pattern: ^[a-z0-9][a-z0-9_-]*$
variables
object | null

Initial key-value variable pairs for this environment

isDefault
boolean | null

Whether this is the default environment for new monitors (default: false)

Response

Created

data
object
required

Environment with variable substitutions for monitor configs