---
title: "Create a new environment"
method: POST
path: "/v1/projects/{projectId}/environments"
tags: ["Environments"]
---

# Create a new environment

`POST /v1/projects/{projectId}/environments`

An endpoint for creating a new environment

## Path parameters

- `projectId` string, uuid, required

## Request body

- CreateEnvironmentRequest
  - `connectionOverrides` ConnectionOverride[], required — Connection overrides for the environment
    - `connectionName` string, required — The name of the connection to override
    - `connectionProperties` object — The connection properties for the connection override
  - `defaultAgentId` string, required — The UUID of the default agent for this environment
  - `defaultConnections` object, required — The default connections for the new environment
  - `defaultUserAccessLevel` string, required — The default role project users will have on the environment
  - `description` string — The description of the new environment
  - `displayName` string — The display name of the new environment
  - `inheritProjectDefaults` boolean — Determines whether the environment inherits the project's default settings
  - `name` string, required — The name of the new environment

## Response `200`

Environment configuration remains unchanged since last update

## Other responses

- `201` — Environment has been created
- `400` — Wrong request parameters used
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Project not Found
- `409` — Conflict
- `422` — Invalid agent ID
- `500` — Unexpected error occurred
- `504` — Gateway timeout

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/versions/6239825f68eb/schema)