创建环境

POST /agent/v1/environments◐ 部分支持

请求体

namestring必填
Human-readable name for the environment
metadataobject可选
User-provided metadata key-value pairs
configobject可选
Environment configuration
▸ 展开子字段（3）
- typestring必填
  Environment type
  取值 self_hosted
- networkingobject可选
  Network configuration policy. Omit on update to preserve the existing value.
- packagesobject可选
  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`.
descriptionstring可选
Optional description of the environment
scopestring可选
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.

200

支持租户自建 cloud 环境、配置更新与软归档；内置环境只读。列表支持 limit、page 和 include_archived。limited 网络在沙箱创建时生效；安装失败会终止会话，错误码为 ENVIRONMENT_PACKAGE_INSTALL_FAILED。self_hosted、scope 和跨会话包缓存尚不支持。

错误按 Anthropic 错误格式返回（type / message / request_id），参见错误码

响应

HTTP 200

Successful response

application/json

名称	类型	说明
id	string	Environment identifier (e.g., 'env_...')
archived_at	null \| string	RFC 3339 timestamp when environment was archived, or null if not archived
config	object	Environment configuration (either Anthropic Cloud or self-hosted)
config.networking	object	Network configuration policy.
config.packages	object	Package manager configuration.
config.type	string	Environment type
created_at	string	RFC 3339 timestamp when environment was created
description	null \| string	User-provided description for the environment; null when unset
metadata	object	User-provided metadata key-value pairs
name	string	Human-readable name for the environment
type	string	The type of object (always 'environment')
updated_at	string	RFC 3339 timestamp when environment was last updated
scope	string	The visibility scope for this environment. 'organization' means visible to all accounts. 'account' means visible only to the owning account.