---
title: "POST /api/{version}/organizations/{orgId}/projects/{projId}/environments"
method: POST
path: "/api/{version}/organizations/{orgId}/projects/{projId}/environments"
tags: ["Environments"]
---

# POST /api/{version}/organizations/{orgId}/projects/{projId}/environments

`POST /api/{version}/organizations/{orgId}/projects/{projId}/environments`

## Path parameters

- `orgId` string, required
- `projId` string, required
- `version` string, required

## Request body

- CreateEnvironmentRequest
  - `name` string, nullable
  - `description` string, nullable
  - `tag` string, nullable
  - `defaultAgentPool` string, nullable

## Response `200`

OK

- EnvironmentDtoItemResponse
  - `item` EnvironmentDto
    - `id` string, nullable
    - `name` string, nullable
    - `description` string, nullable
    - `tag` string, nullable
    - `defaultAgentPool` string, nullable
  - `links` HateoasLink[], nullable
    - `relation` string, nullable
    - `uri` string, nullable
    - `method` string, nullable

## Other responses

- `400` — Validation failed

---

[API](https://skmtc.net/data-grapes/apis/grapes-api.md) · [All operations](https://skmtc.net/data-grapes/apis/grapes-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/data-grapes/grapes-api/revisions/8ff77fe45bba/schema)