---
title: "createEnvironment"
method: POST
path: "/platform/projects/{id}/environments"
tags: ["Platform"]
---

# createEnvironment

`POST /platform/projects/{id}/environments`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/projects/{id}/environments`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Deploy scope. Create or return existing named environment; at most 20 per project.

## Path parameters

- `id` string, required

## Request body

- object
  - `name` string, required

## Response `201`

Metadata operation result

## Other responses

- `400`: Invalid input
- `403`: Required scope missing
- `404`: Resource or current ownership unavailable
- `409`: Conflicting association or active operation
- `429`: Quota exceeded
- `503`: Storage unavailable; read before retrying

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)