---
title: "Updates an environment group's restriction settings"
method: PATCH
path: "/v1/environment_groups/{env_name}"
---

# Updates an environment group's restriction settings

`PATCH /v1/environment_groups/{env_name}`

Sets whether the environment is restricted and replaces the list of users granted manage access. The team-scoped path targets the team in the path; the top-level path targets the caller's organization default team.

## Request body

- UpdateEnvironmentGroupRequestV1 — A request to update an existing environment group.
  - `manage_access` UpdateEnvironmentGroupManageAccessV1 — Manage-access settings to apply to an environment group.
    - `is_restricted` boolean, required — Whether to restrict this environment to a specific set of users.
    - `user_ids` string[] — IDs of users granted manage access while restricted. Only meaningful when is_restricted is true.

## Response `200`

- EnvironmentGroupV1 — A team-scoped grouping of same-named environments (e.g. "production", "staging"). Restricting an environment group limits who can manage the environment of that name across every model and chain in the team.
  - `name` string, required — Name of the environment group, matching the environment name it governs.
  - `team_id` string, required — Unique identifier of the team the environment group belongs to.
  - `team_name` string, required — Name of the team the environment group belongs to.
  - `manage_access` EnvironmentGroupManageAccessV1, required — Who is allowed to manage an environment group.
    - `is_restricted` boolean, required — Whether the environment is restricted to a specific set of users.
    - `users` EnvironmentGroupUserV1[] — Users who can manage the environment while it is restricted, including organization and team admins who always have access. Empty when the environment is unrestricted.
      - `user_id` string, required — Unique identifier for the user.
      - `email` string, nullable — Email address of the user.
      - `name` string, nullable — Display name of the user.

---

[API](https://skmtc.net/baseten/apis/baseten-inference-api.md) · [All operations](https://skmtc.net/baseten/apis/baseten-inference-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/baseten/baseten-inference-api/versions/a55a2f64c3c5/schema)