Create a new environment

POST

/v1/environments

Create a new containerized application environment in Kubernetes

Authorizations

• BearerAuth

Request Body

Create Environment Request

object

app_name

required

string

Example

my-app

container

required

object

env

object

key

additional properties

string

Example

{
  "API_KEY": "secret",
  "DATABASE_URL": "postgres://..."
}

expires_at

Unix timestamp

integer

Example

1672531200

image

required

string

Example

nginx:latest

services

required

object

key

additional properties

object

port

required

integer

>= 1 <= 65535

Example

80

ecrconfig

object

region

string

Example

us-west-1

registry

string

Example

127214170441.dkr.ecr.us-west-1.amazonaws.com

name

required

string

Example

my-environment

resources

object

cpu_limit

string

Example

500m

cpu_request

string

Example

100m

memory_limit

string

Example

512Mi

memory_request

string

Example

128Mi

stage

required

string

Example

my-app-prod

Responses

200

Successfully created environment

object

data

object

createdAt

string

Example

2025-09-29T13:30:00Z

expiresAt

string

Example

2025-09-30T01:30:00Z

id

string

Example

01936b3f-8e4a-7890-abcd-1234567890ab

name

string

Example

my-env

services

Array<object>

object

name

string

Example

rest

url

string

Example

http://localhost/env/lite-enzo/rest

stage

string

Example

dev

error

string

message

string

Example

Successfully created environment 'lite-enzo' in namespace 'lite-enzo'

success

boolean

Example

true

400

Bad request - missing or invalid fields

object

error

string

Example

operation failed

message

string

success

boolean

409

Conflict - namespace already exists

object

error

string

Example

operation failed

message

string

success

boolean

500

Internal server error

object

error

string

Example

operation failed

message

string

success

boolean