> For the complete documentation index, see [llms.txt](/llms.txt).
> A full single-fetch corpus is available at [llms-full.txt](/llms-full.txt).
---
title: "Create an environment"
description: "Create a custom environment beyond the four defaults, for example a per-feature preview environment."
method: "POST"
endpoint: "/api/v1/environments"
order: 3
last_verified: 2026-07-27
---



`POST /api/v1/environments`

Create a custom environment beyond the four defaults, for example a per-feature preview environment.


  ### Body parameters

  - `name` _string_ **required** — The environment's name, e.g. qa.
  - `project_id` _string_ **required** — The owning project's UUID.



  ### Request example


```bash
curl -X POST https://api.agnt5.com/api/v1/environments \
  -H "X-API-KEY: {api_key}" \
  -H "Content-Type: application/json" \
  -d '{"name": "qa", "project_id": "b6f1a3e2-9c4d-4f7a-8e2b-1a2b3c4d5e6f"}'
```

```javascript
fetch('https://api.agnt5.com/api/v1/environments', {
  method: 'POST',
  headers: { 'X-API-KEY': apiKey, 'Content-Type': 'application/json' },
  body: JSON.stringify({ name: 'qa', project_id: projectId })
})
```