Claude Platform Docs

Create Environment

$ ant beta:environments create
POST/v1/environments

Create a new environment with the specified configuration.

Parameters
--name: string

Human-readable name for the environment

minLength1
maxLength256
--config: optional BetaCloudConfigParams or BetaSelfHostedConfigParams

Environment configuration

--description: optional string

Optional description of the environment

maxLength1024
--metadata: optional map[string]

User-provided metadata key-value pairs

--scope: optional "organization" or "account"

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.

--beta: optional array of AnthropicBeta⁠Header parameter

Optional header to specify the beta version(s) you want to use.

--workspace-id: optional string⁠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
beta_environment: object{ type: "environment", id, archived_at, 7 more }

Unified Environment resource for both cloud and self-hosted environments.

type: "environment"

The type of object (always 'environment')

id: string

Environment identifier (e.g., 'env_...')

archived_at: string

RFC 3339 timestamp when environment was archived, or null if not archived

config: BetaCloudConfig or BetaSelfHostedConfig

Environment configuration (either Anthropic Cloud or self-hosted)

One of the following:
beta_cloud_config: object{ type: "cloud", networking, packages }

cloud environment configuration.

beta_self_hosted_config: object{ type: "self_hosted" }

Configuration for self-hosted environments.

type: "self_hosted"

Environment type

created_at: string

RFC 3339 timestamp when environment was created

description: string

User-provided description for the environment; null when unset

metadata: map[string]

User-provided metadata key-value pairs

name: string

Human-readable name for the environment

updated_at: string

RFC 3339 timestamp when environment was last updated

scope: optional "organization" or "account"

The visibility scope for this environment. 'organization' means visible to all accounts. 'account' means visible only to the owning account.

One of the following:
"organization"
"account"
Create Environment
ant beta:environments create \
  --api-key my-anthropic-api-key \
  --name python-data-analysis
Returns Examples
Response 200
{
  "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"
}