# Organization API: Organization deployments: Env groups

> The 5 Organization API operations for env groups.

Source: https://www.coritan.com/docs/api/reference/organizations/organization-deployments/env-groups/

Part of [Organization deployments](/docs/api/reference/organizations/organization-deployments/).

## Operations

| Method | Path | Summary |
| --- | --- | --- |
| GET | [`/api/v1/orgs/{org_slug}/env-groups`](#op-get-api-v1-orgs-org-slug-env-groups) | List groups |
| POST | [`/api/v1/orgs/{org_slug}/env-groups`](#op-post-api-v1-orgs-org-slug-env-groups) | Create an env group |
| GET | [`/api/v1/orgs/{org_slug}/env-groups/{group_uuid}`](#op-get-api-v1-orgs-org-slug-env-groups-group-uuid) | One env group, its variables without values, and the deployments it is linked to |
| PATCH | [`/api/v1/orgs/{org_slug}/env-groups/{group_uuid}`](#op-patch-api-v1-orgs-org-slug-env-groups-group-uuid) | Rename an env group |
| DELETE | [`/api/v1/orgs/{org_slug}/env-groups/{group_uuid}`](#op-delete-api-v1-orgs-org-slug-env-groups-group-uuid) | Delete an env group and its variables |

### List groups {#op-get-api-v1-orgs-org-slug-env-groups}

`GET /api/v1/orgs/{org_slug}/env-groups`

The owner's env groups by name, each with how many variables it has
and how many deployments it is linked to.

#### Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `org_slug` | path | string | yes |

#### Responses

| Status | Meaning |
| --- | --- |
| `200` | Success. |
| `422` | The request is not valid. `detail` lists each problem. |

### Create an env group {#op-post-api-v1-orgs-org-slug-env-groups}

`POST /api/v1/orgs/{org_slug}/env-groups`

Create an env group. Names are unique per owner, ignoring case.

#### Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `org_slug` | path | string | yes |

#### Request body

`application/json` (required)

| Field | Type | Required |
| --- | --- | --- |
| `name` | string | yes |

#### Responses

| Status | Meaning |
| --- | --- |
| `201` | Success. |
| `422` | The request is not valid. `detail` lists each problem. |

### One env group, its variables without values, and the deployments it is linked to {#op-get-api-v1-orgs-org-slug-env-groups-group-uuid}

`GET /api/v1/orgs/{org_slug}/env-groups/{group_uuid}`

One env group, its variables without values, and the deployments it is linked to.

#### Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `group_uuid` | path | string (uuid) | yes |
| `org_slug` | path | string | yes |

#### Responses

| Status | Meaning |
| --- | --- |
| `200` | Success. |
| `422` | The request is not valid. `detail` lists each problem. |

### Rename an env group {#op-patch-api-v1-orgs-org-slug-env-groups-group-uuid}

`PATCH /api/v1/orgs/{org_slug}/env-groups/{group_uuid}`

Rename an env group.

#### Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `group_uuid` | path | string (uuid) | yes |
| `org_slug` | path | string | yes |

#### Request body

`application/json` (required)

| Field | Type | Required |
| --- | --- | --- |
| `name` | string | yes |

#### Responses

| Status | Meaning |
| --- | --- |
| `200` | Success. |
| `422` | The request is not valid. `detail` lists each problem. |

### Delete an env group and its variables {#op-delete-api-v1-orgs-org-slug-env-groups-group-uuid}

`DELETE /api/v1/orgs/{org_slug}/env-groups/{group_uuid}`

Delete an env group and its variables. The deployments it was
linked to (listed in ``unlinked``) lose its values with their next release.

#### Parameters

| Name | In | Type | Required |
| --- | --- | --- | --- |
| `group_uuid` | path | string (uuid) | yes |
| `org_slug` | path | string | yes |

#### Responses

| Status | Meaning |
| --- | --- |
| `200` | Success. |
| `422` | The request is not valid. `detail` lists each problem. |