--- title: Environments url: https://platform.claude.com/docs/en/api/csharp/beta/environments --- # Environments ## Create Environment `BetaEnvironment Beta.Environments.Create(parameters, cancellationToken = default)` **POST** `/v1/environments` Create a new environment with the specified configuration. ### Parameters - `EnvironmentCreateParams parameters` - `required string name` Human-readable name for the environment minLength: 1, maxLength: 256 - `Config? config` 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"` Environment type - `Networking? Networking` Network configuration policy. Omit on update to preserve the existing value. - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type - `class BetaLimitedNetworkParams` Limited network request params. Fields default to null; on update, omitted fields preserve the existing value. - `JsonElement Type = "limited"` Network policy type - `bool? AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. Defaults to `false`. - `bool? AllowPackageManagers` 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. - `IReadOnlyList? AllowedHosts` Specifies domains the container can reach. - `BetaPackagesParams? Packages` Package manager configuration. Under `limited` networking, requires `networking.allow_package_managers` to be `true`. Omit on update to preserve the existing value. - `Type Type` Package configuration type - `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 - `class BetaSelfHostedConfigParams` Request params for `self_hosted` environment configuration. - `JsonElement Type = "self_hosted"` Environment type - `string? description` Optional description of the environment maxLength: 1024 - `IReadOnlyDictionary metadata` User-provided metadata key-value pairs - `Scope? scope` The visibility scope for this environment. 'organization' makes the environment visible to all accounts. 'account' restricts visibility to the owning account only. API organizations support only 'organization'; 'account' is rejected. If not specified, defaults based on organization type. - `Organization("organization")` - `Account("account")` - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string workspaceID` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class BetaEnvironment` Unified Environment resource for both cloud and self-hosted environments. - `JsonElement Type = "environment"` The type of object (always 'environment') - `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. - `JsonElement Type = "cloud"` Environment type - `required Networking Networking` Network configuration policy. - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type - `class BetaLimitedNetwork` Limited network access. - `JsonElement Type = "limited"` Network policy type - `required bool AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. - `required bool 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. - `required BetaPackages Packages` Package manager configuration. - `Type Type` Package configuration type - `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 - `class BetaSelfHostedConfig` Configuration for self-hosted environments. - `JsonElement Type = "self_hosted"` Environment type - `required string CreatedAt` RFC 3339 timestamp when environment was created - `required string? Description` User-provided description for the environment; null when unset - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs - `required string Name` Human-readable name for the 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 using System; using Anthropic.Models.Beta.Environments; EnvironmentCreateParams parameters = new() { Name = "python-data-analysis" }; var betaEnvironment = await client.Beta.Environments.Create(parameters); Console.WriteLine(betaEnvironment); ``` #### Response (200) ```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" } ``` ## List Environments `EnvironmentListPage Beta.Environments.List(parameters, cancellationToken = default)` **GET** `/v1/environments` List environments with pagination support. ### Parameters - `EnvironmentListParams parameters` - `bool includeArchived` (query parameter) Include archived environments in the response - `long limit` (query parameter) Maximum number of environments to return minimum: 1, maximum: 1000 - `string? page` (query parameter) Opaque cursor from previous response for pagination. Pass the `next_page` value from the previous response. - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string workspaceID` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class BetaEnvironment` Unified Environment resource for both cloud and self-hosted environments. - `JsonElement Type = "environment"` The type of object (always 'environment') - `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. - `JsonElement Type = "cloud"` Environment type - `required Networking Networking` Network configuration policy. - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type - `class BetaLimitedNetwork` Limited network access. - `JsonElement Type = "limited"` Network policy type - `required bool AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. - `required bool 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. - `required BetaPackages Packages` Package manager configuration. - `Type Type` Package configuration type - `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 - `class BetaSelfHostedConfig` Configuration for self-hosted environments. - `JsonElement Type = "self_hosted"` Environment type - `required string CreatedAt` RFC 3339 timestamp when environment was created - `required string? Description` User-provided description for the environment; null when unset - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs - `required string Name` Human-readable name for the 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 using System; using Anthropic.Models.Beta.Environments; EnvironmentListParams parameters = new(); var page = await client.Beta.Environments.List(parameters); await foreach (var item in page.Paginate()) { Console.WriteLine(item); } ``` #### Response (200) ```json { "data": [ { "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" } ], "next_page": "page_MjAyNS0wNS0xNFQwMDowMDowMFo=" } ``` ## Get Environment `BetaEnvironment Beta.Environments.Retrieve(parameters, cancellationToken = default)` **GET** `/v1/environments/{environment_id}` Retrieve a specific environment by ID. ### Parameters - `EnvironmentRetrieveParams parameters` - `required string environmentID` (path parameter) - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string workspaceID` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class BetaEnvironment` Unified Environment resource for both cloud and self-hosted environments. - `JsonElement Type = "environment"` The type of object (always 'environment') - `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. - `JsonElement Type = "cloud"` Environment type - `required Networking Networking` Network configuration policy. - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type - `class BetaLimitedNetwork` Limited network access. - `JsonElement Type = "limited"` Network policy type - `required bool AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. - `required bool 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. - `required BetaPackages Packages` Package manager configuration. - `Type Type` Package configuration type - `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 - `class BetaSelfHostedConfig` Configuration for self-hosted environments. - `JsonElement Type = "self_hosted"` Environment type - `required string CreatedAt` RFC 3339 timestamp when environment was created - `required string? Description` User-provided description for the environment; null when unset - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs - `required string Name` Human-readable name for the 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 using System; using Anthropic.Models.Beta.Environments; EnvironmentRetrieveParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW" }; var betaEnvironment = await client.Beta.Environments.Retrieve(parameters); Console.WriteLine(betaEnvironment); ``` #### Response (200) ```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" } ``` ## Update Environment `BetaEnvironment Beta.Environments.Update(parameters, cancellationToken = default)` **POST** `/v1/environments/{environment_id}` Update an existing environment's configuration. ### Parameters - `EnvironmentUpdateParams parameters` - `required string environmentID` (path parameter) - `Config? config` Updated 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"` Environment type - `Networking? Networking` Network configuration policy. Omit on update to preserve the existing value. - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type - `class BetaLimitedNetworkParams` Limited network request params. Fields default to null; on update, omitted fields preserve the existing value. - `JsonElement Type = "limited"` Network policy type - `bool? AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. Defaults to `false`. - `bool? AllowPackageManagers` 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. - `IReadOnlyList? AllowedHosts` Specifies domains the container can reach. - `BetaPackagesParams? Packages` Package manager configuration. Under `limited` networking, requires `networking.allow_package_managers` to be `true`. Omit on update to preserve the existing value. - `Type Type` Package configuration type - `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 - `class BetaSelfHostedConfigParams` Request params for `self_hosted` environment configuration. - `JsonElement Type = "self_hosted"` Environment type - `string? description` Updated description of the environment. Omit to preserve; null clears to null; an empty string is stored as an empty string. maxLength: 1024 - `IReadOnlyDictionary metadata` User-provided metadata key-value pairs. Set a value to null or empty string to delete the key. - `string? name` Updated name for the environment minLength: 1, maxLength: 256 - `Scope? scope` The visibility scope for this environment. 'organization' makes the environment visible to all accounts. 'account' restricts visibility to the owning account only. - `Organization("organization")` - `Account("account")` - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string workspaceID` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class BetaEnvironment` Unified Environment resource for both cloud and self-hosted environments. - `JsonElement Type = "environment"` The type of object (always 'environment') - `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. - `JsonElement Type = "cloud"` Environment type - `required Networking Networking` Network configuration policy. - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type - `class BetaLimitedNetwork` Limited network access. - `JsonElement Type = "limited"` Network policy type - `required bool AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. - `required bool 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. - `required BetaPackages Packages` Package manager configuration. - `Type Type` Package configuration type - `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 - `class BetaSelfHostedConfig` Configuration for self-hosted environments. - `JsonElement Type = "self_hosted"` Environment type - `required string CreatedAt` RFC 3339 timestamp when environment was created - `required string? Description` User-provided description for the environment; null when unset - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs - `required string Name` Human-readable name for the 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 using System; using Anthropic.Models.Beta.Environments; EnvironmentUpdateParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW" }; var betaEnvironment = await client.Beta.Environments.Update(parameters); Console.WriteLine(betaEnvironment); ``` #### Response (200) ```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" } ``` ## Delete Environment `BetaEnvironmentDeleteResponse Beta.Environments.Delete(parameters, cancellationToken = default)` **DELETE** `/v1/environments/{environment_id}` Delete an environment by ID. Returns a confirmation of the deletion. ### Parameters - `EnvironmentDeleteParams parameters` - `required string environmentID` (path parameter) - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string workspaceID` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class BetaEnvironmentDeleteResponse` Response after deleting an environment. - `JsonElement Type = "environment_deleted"` The type of response - `required string ID` Environment identifier ### Example ```csharp using System; using Anthropic.Models.Beta.Environments; EnvironmentDeleteParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW" }; var betaEnvironmentDeleteResponse = await client.Beta.Environments.Delete(parameters); Console.WriteLine(betaEnvironmentDeleteResponse); ``` #### Response (200) ```json { "id": "env_011CZkZ9X2dpNyB7HsEFoRfW", "type": "environment_deleted" } ``` ## Archive Environment `BetaEnvironment Beta.Environments.Archive(parameters, cancellationToken = default)` **POST** `/v1/environments/{environment_id}/archive` Archive an environment by ID. Archived environments cannot be used to create new sessions. ### Parameters - `EnvironmentArchiveParams parameters` - `required string environmentID` (path parameter) - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string workspaceID` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. ### Returns - `class BetaEnvironment` Unified Environment resource for both cloud and self-hosted environments. - `JsonElement Type = "environment"` The type of object (always 'environment') - `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. - `JsonElement Type = "cloud"` Environment type - `required Networking Networking` Network configuration policy. - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type - `class BetaLimitedNetwork` Limited network access. - `JsonElement Type = "limited"` Network policy type - `required bool AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. - `required bool 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. - `required BetaPackages Packages` Package manager configuration. - `Type Type` Package configuration type - `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 - `class BetaSelfHostedConfig` Configuration for self-hosted environments. - `JsonElement Type = "self_hosted"` Environment type - `required string CreatedAt` RFC 3339 timestamp when environment was created - `required string? Description` User-provided description for the environment; null when unset - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs - `required string Name` Human-readable name for the 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 using System; using Anthropic.Models.Beta.Environments; EnvironmentArchiveParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW" }; var betaEnvironment = await client.Beta.Environments.Archive(parameters); Console.WriteLine(betaEnvironment); ``` #### Response (200) ```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" } ``` ## Domain types ### Beta Cloud Config - `class BetaCloudConfig` `cloud` environment configuration. - `JsonElement Type = "cloud"` Environment type - `required Networking Networking` Network configuration policy. - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type - `class BetaLimitedNetwork` Limited network access. - `JsonElement Type = "limited"` Network policy type - `required bool AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. - `required bool 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. - `required BetaPackages Packages` Package manager configuration. - `Type Type` Package configuration type - `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 ### Beta Cloud Config Params - `class BetaCloudConfigParams` Request params for `cloud` environment configuration. Fields default to null; on update, omitted fields preserve the existing value. - `JsonElement Type = "cloud"` Environment type - `Networking? Networking` Network configuration policy. Omit on update to preserve the existing value. - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type - `class BetaLimitedNetworkParams` Limited network request params. Fields default to null; on update, omitted fields preserve the existing value. - `JsonElement Type = "limited"` Network policy type - `bool? AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. Defaults to `false`. - `bool? AllowPackageManagers` 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. - `IReadOnlyList? AllowedHosts` Specifies domains the container can reach. - `BetaPackagesParams? Packages` Package manager configuration. Under `limited` networking, requires `networking.allow_package_managers` to be `true`. Omit on update to preserve the existing value. - `Type Type` Package configuration type - `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 ### Beta Environment - `class BetaEnvironment` Unified Environment resource for both cloud and self-hosted environments. - `JsonElement Type = "environment"` The type of object (always 'environment') - `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. - `JsonElement Type = "cloud"` Environment type - `required Networking Networking` Network configuration policy. - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type - `class BetaLimitedNetwork` Limited network access. - `JsonElement Type = "limited"` Network policy type - `required bool AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. - `required bool 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. - `required BetaPackages Packages` Package manager configuration. - `Type Type` Package configuration type - `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 - `class BetaSelfHostedConfig` Configuration for self-hosted environments. - `JsonElement Type = "self_hosted"` Environment type - `required string CreatedAt` RFC 3339 timestamp when environment was created - `required string? Description` User-provided description for the environment; null when unset - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs - `required string Name` Human-readable name for the 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")` ### Beta Environment Delete Response - `class BetaEnvironmentDeleteResponse` Response after deleting an environment. - `JsonElement Type = "environment_deleted"` The type of response - `required string ID` Environment identifier ### Beta Limited Network - `class BetaLimitedNetwork` Limited network access. - `JsonElement Type = "limited"` Network policy type - `required bool AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. - `required bool 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. ### Beta Limited Network Params - `class BetaLimitedNetworkParams` Limited network request params. Fields default to null; on update, omitted fields preserve the existing value. - `JsonElement Type = "limited"` Network policy type - `bool? AllowMcpServers` Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array. Defaults to `false`. - `bool? AllowPackageManagers` 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. - `IReadOnlyList? AllowedHosts` Specifies domains the container can reach. ### Beta Packages - `class BetaPackages` Packages (and their versions) available in this environment. - `Type Type` Package configuration type - `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 ### Beta Packages Params - `class BetaPackagesParams` 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`. - `Type Type` Package configuration type - `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 ### Beta Self Hosted Config - `class BetaSelfHostedConfig` Configuration for self-hosted environments. - `JsonElement Type = "self_hosted"` Environment type ### Beta Self Hosted Config Params - `class BetaSelfHostedConfigParams` Request params for `self_hosted` environment configuration. - `JsonElement Type = "self_hosted"` Environment type ### Beta Unrestricted Network - `class BetaUnrestrictedNetwork` Unrestricted network access. - `JsonElement Type = "unrestricted"` Network policy type ## Environments › Work ### Get Work Item `BetaSelfHostedWork Beta.Environments.Work.Retrieve(parameters, cancellationToken = default)` **GET** `/v1/environments/{environment_id}/work/{work_id}` Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly. Retrieve detailed information about a specific work item. #### Parameters - `WorkRetrieveParams parameters` - `required string environmentID` (path parameter) - `required string workID` (path parameter) - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string workspaceID` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. #### Returns - `class BetaSelfHostedWork` Work resource representing a unit of work in a self-hosted environment. Work items are queued when sessions are created or when long-dormant sessions receive new messages. The environment worker polls for work to execute in a self-hosted sandbox. - `JsonElement Type = "work"` The type of object (always 'work') - `required string ID` Work identifier (e.g., 'work_...') - `required string? AcknowledgedAt` RFC 3339 timestamp when the work item was acknowledged and assigned to a self-hosted sandbox - `required string CreatedAt` RFC 3339 timestamp when work was created - `required BetaSessionWorkData Data` The actual work to be performed - `JsonElement Type = "session"` Type of work data - `required string ID` Session identifier (e.g., 'session_...') - `required string EnvironmentID` Environment identifier this work belongs to (e.g., `env_...`) - `required string? LatestHeartbeatAt` RFC 3339 timestamp of the most recent heartbeat - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs associated with this work item - `required string? Secret` Credential payload used by the environment worker to execute this work item. May be populated when polling for work; null on all other retrieval paths. - `required string? StartedAt` RFC 3339 timestamp when work execution started - `required State State` Current state of the work item - `Queued("queued")` - `Starting("starting")` - `Active("active")` - `Stopping("stopping")` - `Stopped("stopped")` - `required string? StopRequestedAt` RFC 3339 timestamp when stop was requested - `required string? StoppedAt` RFC 3339 timestamp when work execution stopped #### Example ```csharp using System; using Anthropic.Models.Beta.Environments.Work; WorkRetrieveParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW", WorkID = "work_id", }; var betaSelfHostedWork = await client.Beta.Environments.Work.Retrieve(parameters); Console.WriteLine(betaSelfHostedWork); ``` ##### Response (200) ```json { "id": "id", "acknowledged_at": "acknowledged_at", "created_at": "created_at", "data": { "id": "id", "type": "session" }, "environment_id": "environment_id", "latest_heartbeat_at": "latest_heartbeat_at", "metadata": { "foo": "string" }, "secret": "secret", "started_at": "started_at", "state": "queued", "stop_requested_at": "stop_requested_at", "stopped_at": "stopped_at", "type": "work" } ``` ### Poll for Work `BetaSelfHostedWork? Beta.Environments.Work.Poll(parameters, cancellationToken = default)` **GET** `/v1/environments/{environment_id}/work/poll` Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly. Long poll for work items in the queue. #### Parameters - `WorkPollParams parameters` - `required string environmentID` (path parameter) - `long? blockMs` (query parameter) How long to wait for work to arrive before returning. Must be 1-999 in milliseconds. Defaults to non-blocking (returns immediately if no work is available). minimum: 1 - `long? reclaimOlderThanMs` (query parameter) Reclaim unacknowledged work items older than this many milliseconds. If omitted, uses the default (5000ms). minimum: 1 - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string anthropicWorkerID` (header parameter) Unique identifier for the specific worker polling, used to track aggregated environment-level work metrics in Console #### Returns - `class BetaSelfHostedWork` Work resource representing a unit of work in a self-hosted environment. Work items are queued when sessions are created or when long-dormant sessions receive new messages. The environment worker polls for work to execute in a self-hosted sandbox. - `JsonElement Type = "work"` The type of object (always 'work') - `required string ID` Work identifier (e.g., 'work_...') - `required string? AcknowledgedAt` RFC 3339 timestamp when the work item was acknowledged and assigned to a self-hosted sandbox - `required string CreatedAt` RFC 3339 timestamp when work was created - `required BetaSessionWorkData Data` The actual work to be performed - `JsonElement Type = "session"` Type of work data - `required string ID` Session identifier (e.g., 'session_...') - `required string EnvironmentID` Environment identifier this work belongs to (e.g., `env_...`) - `required string? LatestHeartbeatAt` RFC 3339 timestamp of the most recent heartbeat - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs associated with this work item - `required string? Secret` Credential payload used by the environment worker to execute this work item. May be populated when polling for work; null on all other retrieval paths. - `required string? StartedAt` RFC 3339 timestamp when work execution started - `required State State` Current state of the work item - `Queued("queued")` - `Starting("starting")` - `Active("active")` - `Stopping("stopping")` - `Stopped("stopped")` - `required string? StopRequestedAt` RFC 3339 timestamp when stop was requested - `required string? StoppedAt` RFC 3339 timestamp when work execution stopped #### Example ```csharp using System; using Anthropic.Models.Beta.Environments.Work; WorkPollParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW" }; var betaSelfHostedWork = await client.Beta.Environments.Work.Poll(parameters); Console.WriteLine(betaSelfHostedWork); ``` ##### Response (200) ```json { "id": "id", "acknowledged_at": "acknowledged_at", "created_at": "created_at", "data": { "id": "id", "type": "session" }, "environment_id": "environment_id", "latest_heartbeat_at": "latest_heartbeat_at", "metadata": { "foo": "string" }, "secret": "secret", "started_at": "started_at", "state": "queued", "stop_requested_at": "stop_requested_at", "stopped_at": "stopped_at", "type": "work" } ``` ### Acknowledge Work `BetaSelfHostedWork Beta.Environments.Work.Ack(parameters, cancellationToken = default)` **POST** `/v1/environments/{environment_id}/work/{work_id}/ack` Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly. Acknowledge receipt of a work item, transitioning it from 'queued' to 'starting' and removing it from the queue. #### Parameters - `WorkAckParams parameters` - `required string environmentID` (path parameter) - `required string workID` (path parameter) - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` #### Returns - `class BetaSelfHostedWork` Work resource representing a unit of work in a self-hosted environment. Work items are queued when sessions are created or when long-dormant sessions receive new messages. The environment worker polls for work to execute in a self-hosted sandbox. - `JsonElement Type = "work"` The type of object (always 'work') - `required string ID` Work identifier (e.g., 'work_...') - `required string? AcknowledgedAt` RFC 3339 timestamp when the work item was acknowledged and assigned to a self-hosted sandbox - `required string CreatedAt` RFC 3339 timestamp when work was created - `required BetaSessionWorkData Data` The actual work to be performed - `JsonElement Type = "session"` Type of work data - `required string ID` Session identifier (e.g., 'session_...') - `required string EnvironmentID` Environment identifier this work belongs to (e.g., `env_...`) - `required string? LatestHeartbeatAt` RFC 3339 timestamp of the most recent heartbeat - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs associated with this work item - `required string? Secret` Credential payload used by the environment worker to execute this work item. May be populated when polling for work; null on all other retrieval paths. - `required string? StartedAt` RFC 3339 timestamp when work execution started - `required State State` Current state of the work item - `Queued("queued")` - `Starting("starting")` - `Active("active")` - `Stopping("stopping")` - `Stopped("stopped")` - `required string? StopRequestedAt` RFC 3339 timestamp when stop was requested - `required string? StoppedAt` RFC 3339 timestamp when work execution stopped #### Example ```csharp using System; using Anthropic.Models.Beta.Environments.Work; WorkAckParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW", WorkID = "work_id", }; var betaSelfHostedWork = await client.Beta.Environments.Work.Ack(parameters); Console.WriteLine(betaSelfHostedWork); ``` ##### Response (200) ```json { "id": "id", "acknowledged_at": "acknowledged_at", "created_at": "created_at", "data": { "id": "id", "type": "session" }, "environment_id": "environment_id", "latest_heartbeat_at": "latest_heartbeat_at", "metadata": { "foo": "string" }, "secret": "secret", "started_at": "started_at", "state": "queued", "stop_requested_at": "stop_requested_at", "stopped_at": "stopped_at", "type": "work" } ``` ### Record Heartbeat `BetaSelfHostedWorkHeartbeatResponse Beta.Environments.Work.Heartbeat(parameters, cancellationToken = default)` **POST** `/v1/environments/{environment_id}/work/{work_id}/heartbeat` Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly. Record a heartbeat for a work item to maintain the lease. #### Parameters - `WorkHeartbeatParams parameters` - `required string environmentID` (path parameter) - `required string workID` (path parameter) - `long? desiredTtlSeconds` (query parameter) Desired TTL in seconds - `string? expectedLastHeartbeat` (query parameter) Expected last_heartbeat for conditional update (optimistic concurrency). Use literal 'NO_HEARTBEAT' to claim an unclaimed lease (first heartbeat). For subsequent heartbeats, echo the server's previous last_heartbeat value exactly. Returns 412 Precondition Failed if the actual value doesn't match. - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` #### Returns - `class BetaSelfHostedWorkHeartbeatResponse` Response after recording a heartbeat for a work item. - `JsonElement Type = "work_heartbeat"` The type of response - `required string LastHeartbeat` RFC 3339 timestamp of the most recent heartbeat recorded for this work item, or an empty string if none has been recorded - `required bool LeaseExtended` Whether the heartbeat succeeded in extending the lease - `required State State` Current state of the work item (active/stopping/stopped) - `Queued("queued")` - `Starting("starting")` - `Active("active")` - `Stopping("stopping")` - `Stopped("stopped")` - `required long TtlSeconds` Effective TTL applied to the lease #### Example ```csharp using System; using Anthropic.Models.Beta.Environments.Work; WorkHeartbeatParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW", WorkID = "work_id", }; var betaSelfHostedWorkHeartbeatResponse = await client.Beta.Environments.Work.Heartbeat(parameters); Console.WriteLine(betaSelfHostedWorkHeartbeatResponse); ``` ##### Response (200) ```json { "last_heartbeat": "last_heartbeat", "lease_extended": true, "state": "queued", "ttl_seconds": 0, "type": "work_heartbeat" } ``` ### Stop Work `BetaSelfHostedWork Beta.Environments.Work.Stop(parameters, cancellationToken = default)` **POST** `/v1/environments/{environment_id}/work/{work_id}/stop` Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly. Stop a work item, initiating graceful or forced shutdown. #### Parameters - `WorkStopParams parameters` - `required string environmentID` (path parameter) - `required string workID` (path parameter) - `bool force` If true, immediately stop work without graceful shutdown - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string workspaceID` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. #### Returns - `class BetaSelfHostedWork` Work resource representing a unit of work in a self-hosted environment. Work items are queued when sessions are created or when long-dormant sessions receive new messages. The environment worker polls for work to execute in a self-hosted sandbox. - `JsonElement Type = "work"` The type of object (always 'work') - `required string ID` Work identifier (e.g., 'work_...') - `required string? AcknowledgedAt` RFC 3339 timestamp when the work item was acknowledged and assigned to a self-hosted sandbox - `required string CreatedAt` RFC 3339 timestamp when work was created - `required BetaSessionWorkData Data` The actual work to be performed - `JsonElement Type = "session"` Type of work data - `required string ID` Session identifier (e.g., 'session_...') - `required string EnvironmentID` Environment identifier this work belongs to (e.g., `env_...`) - `required string? LatestHeartbeatAt` RFC 3339 timestamp of the most recent heartbeat - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs associated with this work item - `required string? Secret` Credential payload used by the environment worker to execute this work item. May be populated when polling for work; null on all other retrieval paths. - `required string? StartedAt` RFC 3339 timestamp when work execution started - `required State State` Current state of the work item - `Queued("queued")` - `Starting("starting")` - `Active("active")` - `Stopping("stopping")` - `Stopped("stopped")` - `required string? StopRequestedAt` RFC 3339 timestamp when stop was requested - `required string? StoppedAt` RFC 3339 timestamp when work execution stopped #### Example ```csharp using System; using Anthropic.Models.Beta.Environments.Work; WorkStopParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW", WorkID = "work_id", }; var betaSelfHostedWork = await client.Beta.Environments.Work.Stop(parameters); Console.WriteLine(betaSelfHostedWork); ``` ##### Response (200) ```json { "id": "id", "acknowledged_at": "acknowledged_at", "created_at": "created_at", "data": { "id": "id", "type": "session" }, "environment_id": "environment_id", "latest_heartbeat_at": "latest_heartbeat_at", "metadata": { "foo": "string" }, "secret": "secret", "started_at": "started_at", "state": "queued", "stop_requested_at": "stop_requested_at", "stopped_at": "stopped_at", "type": "work" } ``` ### List Work Items `WorkListPage Beta.Environments.Work.List(parameters, cancellationToken = default)` **GET** `/v1/environments/{environment_id}/work` Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly. List work items in an environment. #### Parameters - `WorkListParams parameters` - `required string environmentID` (path parameter) - `long limit` (query parameter) Maximum number of work items to return minimum: 1, maximum: 1000 - `string? page` (query parameter) Opaque cursor from previous response for pagination - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` #### Returns - `class BetaSelfHostedWork` Work resource representing a unit of work in a self-hosted environment. Work items are queued when sessions are created or when long-dormant sessions receive new messages. The environment worker polls for work to execute in a self-hosted sandbox. - `JsonElement Type = "work"` The type of object (always 'work') - `required string ID` Work identifier (e.g., 'work_...') - `required string? AcknowledgedAt` RFC 3339 timestamp when the work item was acknowledged and assigned to a self-hosted sandbox - `required string CreatedAt` RFC 3339 timestamp when work was created - `required BetaSessionWorkData Data` The actual work to be performed - `JsonElement Type = "session"` Type of work data - `required string ID` Session identifier (e.g., 'session_...') - `required string EnvironmentID` Environment identifier this work belongs to (e.g., `env_...`) - `required string? LatestHeartbeatAt` RFC 3339 timestamp of the most recent heartbeat - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs associated with this work item - `required string? Secret` Credential payload used by the environment worker to execute this work item. May be populated when polling for work; null on all other retrieval paths. - `required string? StartedAt` RFC 3339 timestamp when work execution started - `required State State` Current state of the work item - `Queued("queued")` - `Starting("starting")` - `Active("active")` - `Stopping("stopping")` - `Stopped("stopped")` - `required string? StopRequestedAt` RFC 3339 timestamp when stop was requested - `required string? StoppedAt` RFC 3339 timestamp when work execution stopped #### Example ```csharp using System; using Anthropic.Models.Beta.Environments.Work; WorkListParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW" }; var page = await client.Beta.Environments.Work.List(parameters); await foreach (var item in page.Paginate()) { Console.WriteLine(item); } ``` ##### Response (200) ```json { "data": [ { "id": "id", "acknowledged_at": "acknowledged_at", "created_at": "created_at", "data": { "id": "id", "type": "session" }, "environment_id": "environment_id", "latest_heartbeat_at": "latest_heartbeat_at", "metadata": { "foo": "string" }, "secret": "secret", "started_at": "started_at", "state": "queued", "stop_requested_at": "stop_requested_at", "stopped_at": "stopped_at", "type": "work" } ], "next_page": "next_page" } ``` ### Update Work Item `BetaSelfHostedWork Beta.Environments.Work.Update(parameters, cancellationToken = default)` **POST** `/v1/environments/{environment_id}/work/{work_id}` Note: these endpoints are called automatically by the pre-built environment worker provided in the SDKs and CLI, for orchestrating sessions with self-hosted sandbox environments. They are included here as a reference; you do not need to invoke them directly. Update work item metadata with merge semantics. #### Parameters - `WorkUpdateParams parameters` - `required string environmentID` (path parameter) - `required string workID` (path parameter) - `required IReadOnlyDictionary metadata` Metadata patch. Set a key to a string to upsert it, or to null to delete it. Omit the field to preserve existing metadata. - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string workspaceID` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. #### Returns - `class BetaSelfHostedWork` Work resource representing a unit of work in a self-hosted environment. Work items are queued when sessions are created or when long-dormant sessions receive new messages. The environment worker polls for work to execute in a self-hosted sandbox. - `JsonElement Type = "work"` The type of object (always 'work') - `required string ID` Work identifier (e.g., 'work_...') - `required string? AcknowledgedAt` RFC 3339 timestamp when the work item was acknowledged and assigned to a self-hosted sandbox - `required string CreatedAt` RFC 3339 timestamp when work was created - `required BetaSessionWorkData Data` The actual work to be performed - `JsonElement Type = "session"` Type of work data - `required string ID` Session identifier (e.g., 'session_...') - `required string EnvironmentID` Environment identifier this work belongs to (e.g., `env_...`) - `required string? LatestHeartbeatAt` RFC 3339 timestamp of the most recent heartbeat - `required IReadOnlyDictionary Metadata` User-provided metadata key-value pairs associated with this work item - `required string? Secret` Credential payload used by the environment worker to execute this work item. May be populated when polling for work; null on all other retrieval paths. - `required string? StartedAt` RFC 3339 timestamp when work execution started - `required State State` Current state of the work item - `Queued("queued")` - `Starting("starting")` - `Active("active")` - `Stopping("stopping")` - `Stopped("stopped")` - `required string? StopRequestedAt` RFC 3339 timestamp when stop was requested - `required string? StoppedAt` RFC 3339 timestamp when work execution stopped #### Example ```csharp using System; using System.Collections.Generic; using Anthropic.Models.Beta.Environments.Work; WorkUpdateParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW", WorkID = "work_id", Metadata = new Dictionary() { { "foo", "string" } }, }; var betaSelfHostedWork = await client.Beta.Environments.Work.Update(parameters); Console.WriteLine(betaSelfHostedWork); ``` ##### Response (200) ```json { "id": "id", "acknowledged_at": "acknowledged_at", "created_at": "created_at", "data": { "id": "id", "type": "session" }, "environment_id": "environment_id", "latest_heartbeat_at": "latest_heartbeat_at", "metadata": { "foo": "string" }, "secret": "secret", "started_at": "started_at", "state": "queued", "stop_requested_at": "stop_requested_at", "stopped_at": "stopped_at", "type": "work" } ``` ### Get Queue Statistics `BetaSelfHostedWorkQueueStats Beta.Environments.Work.Stats(parameters, cancellationToken = default)` **GET** `/v1/environments/{environment_id}/work/stats` Get statistics about the work queue for an environment. #### Parameters - `WorkStatsParams parameters` - `required string environmentID` (path parameter) - `IReadOnlyList betas` (header parameter) Optional header to specify the beta version(s) you want to use. - `MessageBatches2024_09_24("message-batches-2024-09-24")` - `PromptCaching2024_07_31("prompt-caching-2024-07-31")` - `ComputerUse2024_10_22("computer-use-2024-10-22")` - `ComputerUse2025_01_24("computer-use-2025-01-24")` - `Pdfs2024_09_25("pdfs-2024-09-25")` - `TokenCounting2024_11_01("token-counting-2024-11-01")` - `TokenEfficientTools2025_02_19("token-efficient-tools-2025-02-19")` - `Output128k2025_02_19("output-128k-2025-02-19")` - `FilesApi2025_04_14("files-api-2025-04-14")` - `McpClient2025_04_04("mcp-client-2025-04-04")` - `McpClient2025_11_20("mcp-client-2025-11-20")` - `DevFullThinking2025_05_14("dev-full-thinking-2025-05-14")` - `InterleavedThinking2025_05_14("interleaved-thinking-2025-05-14")` - `CodeExecution2025_05_22("code-execution-2025-05-22")` - `ExtendedCacheTtl2025_04_11("extended-cache-ttl-2025-04-11")` - `Context1m2025_08_07("context-1m-2025-08-07")` - `ContextManagement2025_06_27("context-management-2025-06-27")` - `ModelContextWindowExceeded2025_08_26("model-context-window-exceeded-2025-08-26")` - `Skills2025_10_02("skills-2025-10-02")` - `FastMode2026_02_01("fast-mode-2026-02-01")` - `Output300k2026_03_24("output-300k-2026-03-24")` - `UserProfiles2026_03_24("user-profiles-2026-03-24")` - `UserProfiles2026_08_18("user-profiles-2026-08-18")` - `UserProfiles2026_09_04("user-profiles-2026-09-04")` - `AdvisorTool2026_03_01("advisor-tool-2026-03-01")` - `ManagedAgents2026_04_01("managed-agents-2026-04-01")` - `CacheDiagnosis2026_04_07("cache-diagnosis-2026-04-07")` - `Dreaming2026_04_21("dreaming-2026-04-21")` - `ThinkingTokenCount2026_05_13("thinking-token-count-2026-05-13")` - `ServerSideFallback2026_06_01("server-side-fallback-2026-06-01")` - `ServerSideFallback2026_07_01("server-side-fallback-2026-07-01")` - `FallbackCredit2026_06_01("fallback-credit-2026-06-01")` - `FallbackCredit2026_07_01("fallback-credit-2026-07-01")` - `AgentMemory2026_07_22("agent-memory-2026-07-22")` - `MidConversationToolChanges2026_07_01("mid-conversation-tool-changes-2026-07-01")` - `Compact2026_01_12("compact-2026-01-12")` - `ComputerUse2025_11_24("computer-use-2025-11-24")` - `McpTunnels2026_06_22("mcp-tunnels-2026-06-22")` - `StructuredOutputs2025_11_13("structured-outputs-2025-11-13")` - `TaskBudgets2026_03_13("task-budgets-2026-03-13")` - `ThinkingDisplayUpdates2026_08_18("thinking-display-updates-2026-08-18")` - `CEUserManagement2026_07_13("ce-user-management-2026-07-13")` - `MidConversationOutputConfig2026_07_01("mid-conversation-output-config-2026-07-01")` - `ThinkingBindingControls2026_08_01("thinking-binding-controls-2026-08-01")` - `MidConversationSystemClearAt2026_08_21("mid-conversation-system-clear-at-2026-08-21")` - `Compact2026_09_04("compact-2026-09-04")` - `InlineTools2026_09_15("inline-tools-2026-09-15")` - `McpClient2026_09_15("mcp-client-2026-09-15")` - `CEPlugins2026_09_01("ce-plugins-2026-09-01")` - `SpendLimitReads2026_09_26("spend-limit-reads-2026-09-26")` - `TelemetryDestinations2026_08_11("telemetry-destinations-2026-08-11")` - `Webhooks2026_10_07("webhooks-2026-10-07")` - `MessageThreads2026_08_12("message-threads-2026-08-12")` - `AnalyticsUsageCost2026_08_24("analytics-usage-cost-2026-08-24")` - `ExperimentalClaudeTag2026_10_21("experimental-claude-tag-2026-10-21")` - `string workspaceID` (header parameter) Optional header to select the Workspace for this request. The value is a Workspace ID (for example, `wrkspc_011CZkZaBF1tNoB5wlCeusgy`). Only needed for credentials that can act on more than one Workspace. A credential that belongs to a specific Workspace may omit it; if sent, it must match that Workspace. #### Returns - `class BetaSelfHostedWorkQueueStats` Statistics about the work queue for an environment. - `JsonElement Type = "work_queue_stats"` The type of object - `required long Depth` Number of work items waiting to be picked up - `required string? OldestQueuedAt` RFC 3339 timestamp of oldest item in the work stream (includes both queued and pending items), null if stream empty - `required long Pending` Number of work items being processed (polled but not acknowledged) - `required long? WorkersPolling` Number of workers that have polled for work in the last 30 seconds. Requires worker_id to be sent with poll requests. #### Example ```csharp using System; using Anthropic.Models.Beta.Environments.Work; WorkStatsParams parameters = new() { EnvironmentID = "env_011CZkZ9X2dpNyB7HsEFoRfW" }; var betaSelfHostedWorkQueueStats = await client.Beta.Environments.Work.Stats(parameters); Console.WriteLine(betaSelfHostedWorkQueueStats); ``` ##### Response (200) ```json { "depth": 0, "oldest_queued_at": "oldest_queued_at", "pending": 0, "type": "work_queue_stats", "workers_polling": 0 } ```