Page history
Update Environment
api/beta/environments/update
History
api/beta/environments/update Changed · +18 / -2 lines
from line 16
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 38 more` - `"message-batches-2024-09-24"`
from line 86
- `"mid-conversation-tool-changes-2026-07-01"` + - `"compact-2026-01-12"` + + - `"computer-use-2025-11-24"` + + - `"mcp-tunnels-2026-06-22"` + + - `"structured-outputs-2025-11-13"` + + - `"task-budgets-2026-03-13"` + + - `"thinking-display-updates-2026-08-18"` + + - `"ce-user-management-2026-07-13"` + ## Body parameters - `config: optional BetaCloudConfigParams or BetaSelfHostedConfigParams or null`
from line 146
- `allow_package_managers: optional boolean or null` - Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the `allowed_hosts` array. Defaults to `false`. + Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the `allowed_hosts` array. Defaults to `false` on creation. Must be `true` when `packages` are specified. - `allowed_hosts: optional array of string or null`
from line 157
Specify packages (and optionally their versions) available in this environment. When versioning, use the version semantics relevant for the package manager, e.g. for `pip` use `package==1.0.0`. You are responsible for validating the package and version exist. Unversioned installs the latest. + + Under `limited` networking, requires `networking.allow_package_managers` to be `true`. - `apt: optional array of string or null`
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 {
api/beta/environments/update Changed · +7 / -5 lines
from line 21
- `string` - - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more` + - `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 31 more` - `"message-batches-2024-09-24"`
from line 67
- `"user-profiles-2026-03-24"` + - `"user-profiles-2026-08-18"` + - `"advisor-tool-2026-03-01"` - `"managed-agents-2026-04-01"`
from line 197
- `description: optional string or null` - Updated description of the environment + Updated description of the environment. Omit to preserve; null clears to null; an empty string is stored as an empty string. - `metadata: optional map[string]`
from line 327
RFC 3339 timestamp when environment was created - - `description: string` + - `description: string or null` - User-provided description for the environment + User-provided description for the environment; null when unset - `metadata: map[string]`
api/beta/environments/update First recorded · 418 lines, first recorded
## Update Environment ### Path Parameters ### Header Parameters ### Body Parameters ### Returns ### Example #### Response
The first capture of this source. The page was already there, and this is what it said.
---
title: Update Environment
url: https://platform.claude.com/docs/en/api/beta/environments/update
---
## Update Environment
**post** `/v1/environments/{environment_id}`
Update an existing environment's configuration.
### Path Parameters
- `environment_id: string`
### Header Parameters
- `"anthropic-beta": optional array of AnthropicBeta`
Optional header to specify the beta version(s) you want to use.
- `string`
- `"message-batches-2024-09-24" or "prompt-caching-2024-07-31" or "computer-use-2024-10-22" or 30 more`
- `"message-batches-2024-09-24"`
- `"prompt-caching-2024-07-31"`
- `"computer-use-2024-10-22"`
- `"computer-use-2025-01-24"`
- `"pdfs-2024-09-25"`
- `"token-counting-2024-11-01"`
- `"token-efficient-tools-2025-02-19"`
- `"output-128k-2025-02-19"`
- `"files-api-2025-04-14"`
- `"mcp-client-2025-04-04"`
- `"mcp-client-2025-11-20"`
- `"dev-full-thinking-2025-05-14"`
- `"interleaved-thinking-2025-05-14"`
- `"code-execution-2025-05-22"`
- `"extended-cache-ttl-2025-04-11"`
- `"context-1m-2025-08-07"`
- `"context-management-2025-06-27"`
- `"model-context-window-exceeded-2025-08-26"`
- `"skills-2025-10-02"`
- `"fast-mode-2026-02-01"`
- `"output-300k-2026-03-24"`
- `"user-profiles-2026-03-24"`
- `"advisor-tool-2026-03-01"`
- `"managed-agents-2026-04-01"`
- `"cache-diagnosis-2026-04-07"`
- `"dreaming-2026-04-21"`
- `"thinking-token-count-2026-05-13"`
- `"server-side-fallback-2026-06-01"`
- `"server-side-fallback-2026-07-01"`
- `"fallback-credit-2026-06-01"`
- `"fallback-credit-2026-07-01"`
- `"agent-memory-2026-07-22"`
- `"mid-conversation-tool-changes-2026-07-01"`
### Body Parameters
- `config: optional BetaCloudConfigParams or BetaSelfHostedConfigParams or null`
Updated environment configuration
- `BetaCloudConfigParams object { type, networking, packages }`
Request params for `cloud` environment configuration.
Fields default to null; on update, omitted fields preserve the
existing value.
- `type: "cloud"`
Environment type
- `"cloud"`
- `networking: optional BetaUnrestrictedNetwork or BetaLimitedNetworkParams or null`
Network configuration policy. Omit on update to preserve the existing value.
- `BetaUnrestrictedNetwork object { type }`
Unrestricted network access.
- `type: "unrestricted"`
Network policy type
- `"unrestricted"`
- `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
existing value.
- `type: "limited"`
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`.
- `allow_package_managers: optional boolean or null`
Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the `allowed_hosts` array. Defaults to `false`.
- `allowed_hosts: optional array of string or null`
Specifies domains the container can reach.
- `packages: optional BetaPackagesParams or null`
Specify packages (and optionally their versions) available in this environment.
When versioning, use the version semantics relevant for the package manager, e.g. for `pip` use `package==1.0.0`. You are responsible for validating the package and version exist. Unversioned installs the latest.
- `apt: optional array of string or null`
Ubuntu/Debian packages to install
- `cargo: optional array of string or null`
Rust packages to install
- `gem: optional array of string or null`
Ruby packages to install
- `go: optional array of string or null`
Go packages to install
- `npm: optional array of string or null`
Node.js packages to install
- `pip: optional array of string or null`
Python packages to install
- `type: optional "packages"`
Package configuration type
- `"packages"`
- `BetaSelfHostedConfigParams object { type }`
Request params for `self_hosted` environment configuration.
- `type: "self_hosted"`
Environment type
- `"self_hosted"`
- `description: optional string or null`
Updated description of the environment
- `metadata: optional map[string]`
User-provided metadata key-value pairs. Set a value to null or empty string to delete the key.
- `name: optional string or null`
Updated name for the environment
- `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.
- `"organization"`
- `"account"`
### Returns
- `BetaEnvironment object { id, archived_at, config, 7 more }`
Unified Environment resource for both cloud and self-hosted environments.
- `id: string`
Environment identifier (e.g., 'env_...')
- `archived_at: string or null`
RFC 3339 timestamp when environment was archived, or null if not archived
- `config: BetaCloudConfig or BetaSelfHostedConfig`
Environment configuration (either Anthropic Cloud or self-hosted)
- `BetaCloudConfig object { networking, packages, type }`
`cloud` environment configuration.
- `networking: BetaUnrestrictedNetwork or BetaLimitedNetwork`
Network configuration policy.
- `BetaUnrestrictedNetwork object { type }`
Unrestricted network access.
- `type: "unrestricted"`
Network policy type
- `"unrestricted"`
- `BetaLimitedNetwork object { allow_mcp_servers, allow_package_managers, allowed_hosts, type }`
Limited network access.
- `allow_mcp_servers: boolean`
Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array.
- `allow_package_managers: boolean`
Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the `allowed_hosts` array.
- `allowed_hosts: array of string`
Specifies domains the container can reach.
- `type: "limited"`
Network policy type
- `"limited"`
- `packages: BetaPackages`
Package manager configuration.
- `apt: array of string`
Ubuntu/Debian packages to install
- `cargo: array of string`
Rust packages to install
- `gem: array of string`
Ruby packages to install
- `go: array of string`
Go packages to install
- `npm: array of string`
Node.js packages to install
- `pip: array of string`
Python packages to install
Cut at 300 lines.