---
title: "Gets an environment group by name"
method: GET
path: "/v1/environment_groups/{env_name}"
---

# Gets an environment group by name

`GET /v1/environment_groups/{env_name}`

Gets a single environment group by name. The team-scoped path targets the team in the path; the top-level path targets the caller's organization default team.

## 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)