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

# Create an environment

`POST /environments`

Create a new environment with an initial set of variable values. The first environment created for a workspace is automatically marked as the default.

## Request body

- CreateEnvironmentsRequest — Request to create a new environment.
  - `name` string, required
  - `values` object, required

## Response `201`

Successful Response

- EnvironmentsResponse — Details of an Orchestra environment with its variable values.
  - `accountId` string, uuid4, required
  - `environmentId` string, uuid4, required
  - `name` string, required
  - `defaultEnv` boolean, required
  - `values` object, required
  - `createdAt` string, required
  - `updatedAt` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/getorchestra/apis/orchestra-api.md) · [All operations](https://skmtc.dev/getorchestra/apis/orchestra-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getorchestra/orchestra-api/revisions/50f4d2ba114d/schema)