One change

Update Environment

api/beta/environments/update

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/update Changed · +29 / -46 lines

# Update Environment ## Path parameters ## Headers ## Body parameters ## Returns ## Example ### Response (200) ## Update Environment ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response

from line 1

----
-title: Update Environment
-url: https://platform.claude.com/docs/en/api/beta/environments/update
----
+# Update Environment
 
-## Update Environment
+**POST** `/v1/environments/{environment_id}`
 
-**post** `/v1/environments/{environment_id}`
-
 Update an existing environment's configuration.
 
-### Path Parameters
+## Path parameters
 
 - `environment_id: string`
 
-### Header Parameters
+## Headers
 
 - `"anthropic-beta": optional array of AnthropicBeta`

from line 86

 
     - `"mid-conversation-tool-changes-2026-07-01"`
 
-### Body Parameters
+## Body parameters
 
 - `config: optional BetaCloudConfigParams or BetaSelfHostedConfigParams or null`
 
   Updated environment configuration
 
-  - `BetaCloudConfigParams object { type, networking, packages }`
+  - `BetaCloudConfigParams object`
 
     Request params for `cloud` environment configuration.

from line 103

 
       Environment type
 
-      - `"cloud"`
-
     - `networking: optional BetaUnrestrictedNetwork or BetaLimitedNetworkParams or null`
 
       Network configuration policy. Omit on update to preserve the existing value.
 
-      - `BetaUnrestrictedNetwork object { type }`
+      - `BetaUnrestrictedNetwork object`
 
         Unrestricted network access.

from line 115

 
           Network policy type
 
-          - `"unrestricted"`
+      - `BetaLimitedNetworkParams object`
 
-      - `BetaLimitedNetworkParams object { type, allow_mcp_servers, allow_package_managers, allowed_hosts }`
-
         Limited network request params.
 
         Fields default to null; on update, omitted fields preserve the

from line 126

 
           Network policy type
 
-          - `"limited"`
-
         - `allow_mcp_servers: optional boolean or null`
 
           Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. Defaults to `false`.

from line 172

 
         Package configuration type
 
-        - `"packages"`
+        default: packages
 
-  - `BetaSelfHostedConfigParams object { type }`
+  - `BetaSelfHostedConfigParams object`
 
     Request params for `self_hosted` environment configuration.

from line 182

 
       Environment type
 
-      - `"self_hosted"`
-
 - `description: optional string or null`
 
   Updated description of the environment. Omit to preserve; null clears to null; an empty string is stored as an empty string.
 
+  maxLength: 1024
+
 - `metadata: optional map[string]`
 
   User-provided metadata key-value pairs. Set a value to null or empty string to delete the key.

from line 196

 
   Updated name for the environment
 
+  maxLength: 256, minLength: 1
+
 - `scope: optional "organization" or "account" or null`
 
   The visibility scope for this environment. 'organization' makes the environment visible to all accounts. 'account' restricts visibility to the owning account only.

from line 206

 
   - `"account"`
 
-### Returns
+## Returns
 
-- `BetaEnvironment object { id, archived_at, config, 7 more }`
+- `BetaEnvironment object`
 
   Unified Environment resource for both cloud and self-hosted environments.

from line 224

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

from line 232

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

from line 240

 
             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 260

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

from line 292

 
           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 306

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

from line 326

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

from line 340

 
     - `"account"`
 
-### Example
+## Example
 
-```http
+```bash
 curl https://api.anthropic.com/v1/environments/$ENVIRONMENT_ID \
     -H 'Content-Type: application/json' \
     -H 'anthropic-version: 2023-06-01' \

from line 353

         }'
 ```
 
-#### Response
+### Response (200)
 
 ```json
 {