---
title: "putEnvironmentGroup"
method: PUT
path: "/v1/environments/groups/{name}"
tags: ["environments"]
---

# putEnvironmentGroup

`PUT /v1/environments/groups/{name}`

Create or update an environment group by name. Acts as an upsert — creates the group if it does not exist.

## Request body

- EnvironmentGroupUpsertRequest
  - `description` string

## Response `200`

Updated group

- EnvironmentGroup
  - `name` string, required
  - `description` string
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `201` — Created group
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.dev/epilot/apis/environments-api.md) · [All operations](https://skmtc.dev/epilot/apis/environments-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/epilot/environments-api/revisions/6e9b212bbe77/schema)