One change

List Environments

api/beta/environments/list

25 Aug 2026 03:37 UTC first seen 14 Aug 2026 The page's own history The capture it came from

Nearest release: v2.1.245, published an hour after this site recorded the change. Shown because the two are within 24 hours of each other. Nothing here says the release caused the edit.

api/beta/environments/list Changed · +20 / -29 lines

# List Environments ## Query parameters ## Headers ## Returns ## Example ### Response (200) ## List Environments ### Query Parameters ### Header Parameters ### Returns ### Example #### Response

from line 1

----
-title: List Environments
-url: https://platform.claude.com/docs/en/api/beta/environments/list
----
+# List Environments
 
-## List Environments
+**GET** `/v1/environments`
 
-**get** `/v1/environments`
-
 List environments with pagination support.
 
-### Query Parameters
+## Query parameters
 
 - `include_archived: optional boolean`
 
   Include archived environments in the response
 
+  default: false
+
 - `limit: optional number`
 
   Maximum number of environments to return
 
+  default: 20, maximum: 1000, minimum: 1
+
 - `page: optional string`
 
   Opaque cursor from previous response for pagination. Pass the `next_page` value from the previous response.
 
-### Header Parameters
+## Headers
 
 - `"anthropic-beta": optional array of AnthropicBeta`

from line 100

 
     - `"mid-conversation-tool-changes-2026-07-01"`
 
-### Returns
+## Returns
 
 - `data: array of BetaEnvironment`

from line 118

 
     Environment configuration (either Anthropic Cloud or self-hosted)
 
-    - `BetaCloudConfig object { networking, packages, type }`
+    - `BetaCloudConfig object`
 
       `cloud` environment configuration.

from line 126

 
         Network configuration policy.
 
-        - `BetaUnrestrictedNetwork object { type }`
+        - `BetaUnrestrictedNetwork object`
 
           Unrestricted network access.

from line 134

 
             Network policy type
 
-            - `"unrestricted"`
+        - `BetaLimitedNetwork object`
 
-        - `BetaLimitedNetwork object { allow_mcp_servers, allow_package_managers, allowed_hosts, type }`
-
           Limited network access.
 
           - `allow_mcp_servers: boolean`

from line 154

 
             Network policy type
 
-            - `"limited"`
-
       - `packages: BetaPackages`
 
         Package manager configuration.

from line 186

 
           Package configuration type
 
-          - `"packages"`
+          default: packages
 
       - `type: "cloud"`
 
         Environment type
 
-        - `"cloud"`
+    - `BetaSelfHostedConfig object`
 
-    - `BetaSelfHostedConfig object { type }`
-
       Configuration for self-hosted environments.
 
       - `type: "self_hosted"`

from line 200

 
         Environment type
 
-        - `"self_hosted"`
-
   - `created_at: string`
 
     RFC 3339 timestamp when environment was created

from line 220

 
     The type of object (always 'environment')
 
-    - `"environment"`
+    default: environment
 
   - `updated_at: string`

from line 238

 
   Token for fetching the next page of results. If `null`, there are no more results available. Pass this value to the `page` parameter in the next request.
 
-### Example
+## Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/environments \
     -H 'anthropic-version: 2023-06-01' \
     -H 'anthropic-beta: managed-agents-2026-04-01' \

from line 247

     -H "X-Api-Key: $ANTHROPIC_API_KEY"
 ```
 
-#### Response
+### Response (200)
 
 ```json
 {