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

# List environments

`GET /environments`

## Request

- Base URL: `https://api.deepnote.com/v2`
- URL: `https://api.deepnote.com/v2/environments`
- Auth: HTTP bearer

List the environments (Docker images) projects in the workspace can run on, in one response: Deepnote's images first, then the workspace's custom images, each group sorted by name.

## Response `200`

List of environments

- ListEnvironmentsResponse
  - `environments` Environment[], required
    - `id` string, uuid, required
    - `name` string, required
    - `image` string, required: Docker image reference the project machine runs.
    - `type` 'deepnote' | 'custom', required: `deepnote` for images maintained by Deepnote, `custom` for images registered by the workspace. A custom image hosted in a private registry is only pulled when the matching container registry integration (Docker Hub, Amazon ECR, or Google Container Registry) is attached to the project.
    - `language` 'python' | 'r', required: Language of the kernel that notebooks run in this environment.
    - `isDefault` boolean, required: Whether new projects start on this environment. There is one default for CPU machines and one for GPU machines; use `isGpu` to tell them apart.
    - `isGpu` boolean, required: Whether the image is built for GPU machines.
    - `isDeprecated` boolean, required: Deprecated environments keep working for projects that already use them, but should not be chosen.

## Other responses

- `401`: Unauthorized
- `403`: Insufficient permissions
- `429`: Rate limit exceeded

## Changes

- **2026-09-26** `19ebdbd8efe8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/deepnote/apis/deepnote-public-api/changes/environments/get.md)

---

[API](https://skmtc.dev/deepnote/apis/deepnote-public-api.md) - [All operations](https://skmtc.dev/deepnote/apis/deepnote-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/deepnote/apis/deepnote-public-api/revisions/b081f9aea3dc?raw)