---
title: "Create environment"
method: POST
path: "/environments"
tags: ["Projects & Environments"]
---

# Create environment

`POST /environments`

Create a new environment belonging to the project with the provided ID.

## Request body

- EnvironmentPOSTInput
  - `name` string, required
  - `projectId` string, required
  - `protectedStatus` 'unprotected' | 'protected' — Indicates whether an environment is `unprotected` or `protected`. Only admin users can perform destructive actions in `protected` environments.
  - `networkIsolationEnabled` boolean — Indicates whether network connections across environments are allowed.
  - `ipAllowList` CidrBlockAndDescription[]
    - `cidrBlock` string, required
    - `description` string, required — User-provided description of the CIDR block

## Response `201`

Created

- Environment
  - `id` string, required
  - `name` string, required
  - `projectId` string, required
  - `databasesIds` string[], required
  - `ipAllowList` CidrBlockAndDescription[]
    - `cidrBlock` string, required
    - `description` string, required — User-provided description of the CIDR block
  - `redisIds` string[], required
  - `serviceIds` string[], required
  - `envGroupIds` string[], required
  - `protectedStatus` 'unprotected' | 'protected', required — Indicates whether an environment is `unprotected` or `protected`. Only admin users can perform destructive actions in `protected` environments.
  - `networkIsolationEnabled` boolean, required — Indicates whether network connections across environments are allowed.

## Other responses

- `400` — The request could not be understood by the server.
- `401` — Authorization information is missing or invalid.
- `404` — Unable to find the requested resource.
- `429` — Rate limit has been surpassed.
- `500` — An unexpected server error has occurred.
- `503` — Server currently unavailable.

---

[API](https://skmtc.dev/render/apis/render-public-api.md) · [All operations](https://skmtc.dev/render/apis/render-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/render/render-public-api/revisions/80e0ff74d033/schema)