Skip to main content
POST
Create environments with optional initial state

Authorizations

Authorization
string
header
required

Used by lifecycle, catalog, and state endpoints

Headers

Idempotency-Key
string
required
Required string length: 1 - 200

Body

application/json
environments
string[]
required
Minimum array length: 1
Required string length: 1 - 80
ttlSeconds
integer
Required range: 1 <= x <= 14400
initialState
object

Response

Environment session created

sessionId
string
required
Minimum string length: 1
status
enum<string>
required
Available options:
starting,
ready,
running,
tearing_down,
ended,
expired,
failed
environmentIds
string[]
required
Minimum array length: 1
Required string length: 1 - 80
environments
object
required
expiresAt
string
required
Minimum string length: 1
certificationWarnings
object[]
lease
object
workspace
object