Environment

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/anthropic/main/json-schema/anthropic-beta-environment-schema.json",
  "title": "Environment",
  "description": "Unified Environment resource for both cloud and self-hosted environments.",
  "x-generated": "2026-09-23",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/anthropic-environments-api-openapi.yml#/components/schemas/BetaEnvironment",
  "properties": {
    "archived_at": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Archived At",
      "description": "RFC 3339 timestamp when environment was archived, or null if not archived"
    },
    "config": {
      "oneOf": [
        {
          "$ref": "#/$defs/BetaCloudConfig"
        },
        {
          "$ref": "#/$defs/BetaSelfHostedConfig",
          "x-anthropic-beta-required": [
            "managed-agents-2026-04-01"
          ]
        }
      ],
      "title": "Config",
      "description": "Environment configuration (either Anthropic Cloud or self-hosted)"
    },
    "created_at": {
      "type": "string",
      "title": "Created At",
      "description": "RFC 3339 timestamp when environment was created"
    },
    "description": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Description",
      "description": "User-provided description for the environment; null when unset"
    },
    "id": {
      "type": "string",
      "title": "Id",
      "description": "Environment identifier (e.g., 'env_...')"
    },
    "metadata": {
      "additionalProperties": {
        "type": "string"
      },
      "type": "object",
      "title": "Metadata",
      "description": "User-provided metadata key-value pairs"
    },
    "name": {
      "type": "string",
      "title": "Name",
      "description": "Human-readable name for the environment"
    },
    "scope": {
      "type": "string",
      "enum": [
        "organization",
        "account"
      ],
      "title": "Scope",
      "description": "The visibility scope for this environment. 'organization' means visible to all accounts. 'account' means visible only to the owning account.",
      "x-anthropic-beta-required": [
        "managed-agents-2026-04-01"
      ]
    },
    "type": {
      "type": "string",
      "const": "environment",
      "title": "Type",
      "description": "The type of object (always 'environment')",
      "default": "environment"
    },
    "updated_at": {
      "type": "string",
      "title": "Updated At",
      "description": "RFC 3339 timestamp when environment was last updated"
    }
  },
  "type": "object",
  "required": [
    "archived_at",
    "config",
    "created_at",
    "description",
    "id",
    "metadata",
    "name",
    "type",
    "updated_at"
  ],
  "$defs": {
    "BetaCloudConfig": {
      "properties": {
        "networking": {
          "oneOf": [
            {
              "$ref": "#/$defs/BetaUnrestrictedNetwork"
            },
            {
              "$ref": "#/$defs/BetaLimitedNetwork",
              "x-anthropic-beta-required": [
                "managed-agents-2026-04-01"
              ]
            }
          ],
          "title": "Networking",
          "description": "Network configuration policy."
        },
        "packages": {
          "$ref": "#/$defs/BetaPackages",
          "description": "Package manager configuration.",
          "x-anthropic-beta-required": [
            "managed-agents-2026-04-01"
          ]
        },
        "type": {
          "type": "string",
          "const": "cloud",
          "title": "Type",
          "description": "Environment type"
        }
      },
      "type": "object",
      "required": [
        "networking",
        "packages",
        "type"
      ],
      "title": "CloudConfig",
      "description": "`cloud` environment configuration."
    },
    "BetaLimitedNetwork": {
      "properties": {
        "allow_mcp_servers": {
          "type": "boolean",
          "title": "Allow Mcp Servers",
          "description": "Permits outbound access to MCP server endpoints configured on the agent, beyond those listed in the `allowed_hosts` array."
        },
        "allow_package_managers": {
          "type": "boolean",
          "title": "Allow Package Managers",
          "description": "Permits outbound access to public package registries (PyPI, npm, etc.) beyond those listed in the `allowed_hosts` array."
        },
        "allowed_hosts": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Allowed Hosts",
          "description": "Specifies domains the container can reach."
        },
        "type": {
          "type": "string",
          "const": "limited",
          "title": "Type",
          "description": "Network policy type"
        }
      },
      "type": "object",
      "required": [
        "allow_mcp_servers",
        "allow_package_managers",
        "allowed_hosts",
        "type"
      ],
      "title": "LimitedNetwork",
      "description": "Limited network access."
    },
    "BetaPackages": {
      "properties": {
        "apt": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Apt",
          "description": "Ubuntu/Debian packages to install"
        },
        "cargo": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Cargo",
          "description": "Rust packages to install"
        },
        "gem": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Gem",
          "description": "Ruby packages to install"
        },
        "go": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Go",
          "description": "Go packages to install"
        },
        "npm": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Npm",
          "description": "Node.js packages to install"
        },
        "pip": {
          "items": {
            "type": "string"
          },
          "type": "array",
          "title": "Pip",
          "description": "Python packages to install"
        },
        "type": {
          "type": "string",
          "const": "packages",
          "title": "Type",
          "description": "Package configuration type",
          "default": "packages"
        }
      },
      "type": "object",
      "required": [
        "apt",
        "cargo",
        "gem",
        "go",
        "npm",
        "pip"
      ],
      "title": "Packages",
      "description": "Packages (and their versions) available in this environment."
    },
    "BetaSelfHostedConfig": {
      "properties": {
        "type": {
          "type": "string",
          "const": "self_hosted",
          "title": "Type",
          "description": "Environment type"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "type"
      ],
      "title": "SelfHostedConfig",
      "description": "Configuration for self-hosted environments."
    },
    "BetaUnrestrictedNetwork": {
      "properties": {
        "type": {
          "type": "string",
          "const": "unrestricted",
          "title": "Type",
          "description": "Network policy type"
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "type"
      ],
      "title": "UnrestrictedNetwork",
      "description": "Unrestricted network access."
    }
  }
}