---
title: "Lists environment groups"
method: GET
path: "/v1/environment_groups"
---

# Lists environment groups

`GET /v1/environment_groups`

Lists environment groups. The team-scoped path targets the team in the path; the top-level path targets the caller's organization default team.

## Response `200`

- EnvironmentGroupsV1 — A page of environment groups.
  - `items` EnvironmentGroupV1[], required — Items in this page.
    - `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.
  - `pagination` PaginationResponseV1, required
    - `has_more` boolean, required — Whether more items exist after this page.
    - `cursor` string, nullable — Opaque cursor to pass into the next request. Null when there is no next page.

---

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