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

# List environments

`GET /api/v1/environments`

Returns all server-managed environment definitions, sorted by id.

## Response `200`

Environment definitions

- EnvironmentListResponse — List envelope for environment definitions.
  - `data` Environment[], required
    - `id` string, required
    - `revision` string, required — Stable revision used with `If-Match` for optimistic concurrency.
    - `provider` 'local' | 'docker' | 'daytona', required — Desired environment provider.
    - `cwd` string, nullable — Local-provider command working directory for this environment. Docker and Daytona ignore this value.
    - `image` EnvironmentApiImageSettings, required — REST-safe environment image settings. Dockerfile sources are inline-only; local paths are rejected by the REST API.
      - `docker` string, nullable, required
      - `dockerfile` EnvironmentApiDockerfileSourceInline, required
        - `type` 'inline', required
        - `value` string, required
    - `resources` EnvironmentResourcesSettings, required
      - `cpu` integer, nullable, required
      - `memory` string, nullable, required
      - `disk` string, nullable, required
    - `network` EnvironmentNetworkSettings, required
      - `mode` 'allow_all' | 'block' | 'cidr_allow_list', required
      - `allow` string[], required
    - `lifecycle` EnvironmentLifecycleSettings, required
      - `preserve` boolean, required
      - `stop_on_terminal` boolean, required
      - `auto_stop` string, nullable, required
    - `labels` StringMap, required
    - `env` object, required
  - `meta` EnvironmentListMeta, required — Metadata for environment list responses.
    - `total` integer, required — Total number of server-managed environment definitions.

## Other responses

- `500` — Environment store operation failed

## Changes

- **2026-06-14** `fbe22f7c5ef7` — 1 info
  - added the optional property `data/items/cwd` to the response with the `200` status
- **2026-06-13** `de85d0556040` — 1 breaking
  - removed the required property `data/items/volumes` from the response with the `200` status
- **2026-05-29** `254ffe92951a` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/fabro-sh/apis/fabro-run-api/changes/api/v1/environments/get.md)

---

[API](https://skmtc.dev/fabro-sh/apis/fabro-run-api.md) · [All operations](https://skmtc.dev/fabro-sh/apis/fabro-run-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fabro-sh/fabro-run-api/revisions/7bdeefd151cd/schema)