---
title: "List Environments"
method: GET
path: "/v1/environments"
tags: ["Environments"]
---

# List Environments

`GET /v1/environments`

Returns environments visible to the caller, including the singleton Global environment for org scope. Each record includes counts of attached variables, files, skills, and MCPs.

## Query parameters

- `scope` 'org' | 'user' | 'all'

## Response `200`

Successful response

- ListEnvironmentsResponse
  - `environments` Environment[], required
    - `id` string, uuid, required — Unique identifier
    - `organization_id` string, uuid, required — Owning organization
    - `user_id` string, uuid, nullable, required — Owning user for personal environments. Null for team environments.
    - `name` string, required — Human-readable name
    - `description` string, nullable, required — Optional description
    - `is_global` boolean, required — True for the org's singleton Global environment, whose values apply to every workspace. Global envs cannot be deleted, cannot be edited via PATCH, and have no repository binding.
    - `repository_id` string, uuid, nullable, required — Bound repository ID. Mutually exclusive with `repository_set_id`. Both null = unbound repo-less workspace.
    - `repository_set_id` string, uuid, nullable, required — Bound repository set ID. Mutually exclusive with `repository_id`.
    - `system_prompt` string, nullable, required — Optional system prompt prepended to every workspace's coding agent.
    - `mobile_testing_enabled` boolean, required — Whether workspaces from this environment receive mobile simulator access. Available on Team and Enterprise plans and configurable only on team environments.
    - `personal_preferences` string, nullable, required — User-authored instructions appended after the (inherited) system prompt. Only settable on personal environments, and editable even when source-backed.
    - `source_environment_id` string, uuid, nullable, required — Source team environment for source-backed personal environments. Null for standalone personal environments and team environments.
    - `variable_count` integer — Number of variables attached to this environment
    - `file_count` integer — Number of files
    - `skill_count` integer — Number of enabled skills
    - `mcp_count` integer — Number of MCPs
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required

## Other responses

- `401` — Unauthorized - Invalid or missing API key
- `500` — Internal server error

---

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