Create an environment

Create a new environment for a project

POST

/auth/v1/seed/{namespace}/projects/{proj}/environments

curl --request POST \
  --url /auth/v1/seed/{namespace}/projects/{proj}/environments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{"name":"staging","env_vars":{"LOG_LEVEL":"debug","API_URL":"https://staging-api.acme.com"},"deployment_config":{"replicas":1,"auto_deploy":true}}'

Path parameters

namespace

string

required

The namespace (user or organization) the project belongs to.

proj

string

required

The project ID or slug.

Body parameters

name

string

required

A unique environment name within the project (e.g., `production`, `staging`, `preview`).

env_vars

object

Environment variables as key-value pairs.

deployment_config

object

Deployment configuration overrides for this environment (e.g., replicas, auto_deploy).

Previous → List environments

Next Update an environment →