## Create Environment `BetaEnvironment Beta.Environments.Create(EnvironmentCreateParamsparameters, CancellationTokencancellationToken = default)` **post** `/v1/environments` Create a new environment with the specified configuration. ### Parameters - `EnvironmentCreateParams parameters` - `required string name` Body param: Human-readable name for the environment - `Config? config` Body param: Environment configuration - `class BetaCloudConfigParams:` Request params for `cloud` environment configuration. Fields default to null; on update, omitted fields preserve the existing value. - `JsonElement Type "cloud"constant` Environment type - `Networking? Networking` Network configuration policy. Omit on update to preserve the existing value. - `class BetaUnrestrictedNetwork:` Unrestricted network access. - `JsonElement Type "unrestricted"constant` Network policy type - `class BetaLimitedNetworkParams:` Limited network request params. Fields default to null; on update, omitted fields preserve the existing value. - `JsonElement Type "limited"constant` Network policy type - `Boolean? AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. Defaults to `false`. - `Boolean? AllowPackageManagers` Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the `allowed_hosts` array. Defaults to `false`. - `IReadOnlyList? AllowedHosts` Specifies domains the container can reach. - `BetaPackagesParams? Packages` 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. - `IReadOnlyList? Apt` Ubuntu/Debian packages to install - `IReadOnlyList? Cargo` Rust packages to install - `IReadOnlyList? Gem` Ruby packages to install - `IReadOnlyList? Go` Go packages to install - `IReadOnlyList? Npm` Node.js packages to install - `IReadOnlyList? Pip` Python packages to install - `Type Type` Package configuration type - `"packages"Packages` - `class BetaSelfHostedConfigParams:` Request params for `self_hosted` environment configuration. - `JsonElement Type "self_hosted"constant` Environment type - `string? description` Body param: Optional description of the environment - `IReadOnlyDictionary metadata` Body param: User-provided metadata key-value pairs - `Scope? scope` Body param: The visibility scope for this environment. 'organization' makes the environment visible to all accounts. 'account' restricts visibility to the owning account only. Only applicable for self-hosted environments. If not specified, defaults based on organization type. - `"organization"Organization` - `"account"Account` - `IReadOnlyList betas` Header param: Optional header to specify the beta version(s) you want to use. - `"message-batches-2024-09-24"MessageBatches2024_09_24` - `"prompt-caching-2024-07-31"PromptCaching2024_07_31` - `"computer-use-2024-10-22"ComputerUse2024_10_22` - `"computer-use-2025-01-24"ComputerUse2025_01_24` - `"pdfs-2024-09-25"Pdfs2024_09_25` - `"token-counting-2024-11-01"TokenCounting2024_11_01` - `"token-efficient-tools-2025-02-19"TokenEfficientTools2025_02_19` - `"output-128k-2025-02-19"Output128k2025_02_19` - `"files-api-2025-04-14"FilesApi2025_04_14` - `"mcp-client-2025-04-04"McpClient2025_04_04` - `"mcp-client-2025-11-20"McpClient2025_11_20` - `"dev-full-thinking-2025-05-14"DevFullThinking2025_05_14` - `"interleaved-thinking-2025-05-14"InterleavedThinking2025_05_14` - `"code-execution-2025-05-22"CodeExecution2025_05_22` - `"extended-cache-ttl-2025-04-11"ExtendedCacheTtl2025_04_11` - `"context-1m-2025-08-07"Context1m2025_08_07` - `"context-management-2025-06-27"ContextManagement2025_06_27` - `"model-context-window-exceeded-2025-08-26"ModelContextWindowExceeded2025_08_26` - `"skills-2025-10-02"Skills2025_10_02` - `"fast-mode-2026-02-01"FastMode2026_02_01` - `"output-300k-2026-03-24"Output300k2026_03_24` - `"user-profiles-2026-03-24"UserProfiles2026_03_24` - `"advisor-tool-2026-03-01"AdvisorTool2026_03_01` - `"managed-agents-2026-04-01"ManagedAgents2026_04_01` - `"cache-diagnosis-2026-04-07"CacheDiagnosis2026_04_07` - `"thinking-token-count-2026-05-13"ThinkingTokenCount2026_05_13` ### Returns - `class BetaEnvironment:` Unified Environment resource for both cloud and self-hosted environments. - `required string ID` Environment identifier (e.g., 'env_...') - `required string? ArchivedAt` RFC 3339 timestamp when environment was archived, or null if not archived - `required Config Config` Environment configuration (either Anthropic Cloud or self-hosted) - `class BetaCloudConfig:` `cloud` environment configuration. - `required Networking Networking` Network configuration policy. - `class BetaUnrestrictedNetwork:` Unrestricted network access. - `JsonElement Type "unrestricted"constant` Network policy type - `class BetaLimitedNetwork:` Limited network access. - `required Boolean AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. - `required Boolean AllowPackageManagers` Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the `allowed_hosts` array. - `required IReadOnlyList AllowedHosts` Specifies domains the container can reach. - `JsonElement Type "limited"constant` Network policy type - `required BetaPackages Packages` Package manager configuration. - `required IReadOnlyList Apt` Ubuntu/Debian packages to install - `required IReadOnlyList Cargo` Rust packages to install - `required IReadOnlyList Gem` Ruby packages to install - `required IReadOnlyList Go` Go packages to install - `required IReadOnlyList Npm` Node.js packages to install - `required IReadOnlyList Pip` Python packages to install - `Type Type` Package configuration type - `"packages"Packages` - `JsonElement Type "cloud"constant` Environment type - `class BetaSelfHostedConfig:` Configuration for self-hosted environments. - `JsonElement Type "self_hosted"constant` Environment type - `required string CreatedAt` RFC 3339 timestamp when environment was created - `required string Description` User-provided description for the environment - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs - `required string Name` Human-readable name for the environment - `JsonElement Type "environment"constant` The type of object (always 'environment') - `required string UpdatedAt` RFC 3339 timestamp when environment was last updated - `Scope Scope` The visibility scope for this environment. 'organization' means visible to all accounts. 'account' means visible only to the owning account. - `"organization"Organization` - `"account"Account` ### Example ```csharp EnvironmentCreateParams parameters = new() { Name = "python-data-analysis" }; var betaEnvironment = await client.Beta.Environments.Create(parameters); Console.WriteLine(betaEnvironment); ``` #### Response ```json { "id": "env_011CZkZ9X2dpNyB7HsEFoRfW", "archived_at": null, "config": { "networking": { "allow_mcp_servers": false, "allow_package_managers": true, "allowed_hosts": [ "api.example.com" ], "type": "limited" }, "packages": { "apt": [ "string" ], "cargo": [ "string" ], "gem": [ "string" ], "go": [ "string" ], "npm": [ "string" ], "pip": [ "pandas", "numpy" ], "type": "packages" }, "type": "cloud" }, "created_at": "2026-03-15T10:00:00Z", "description": "Python environment with data-analysis packages.", "metadata": {}, "name": "python-data-analysis", "type": "environment", "updated_at": "2026-03-15T10:00:00Z", "scope": "organization" } ```