Skip to main content
POST
创建 Environment

Authorizations

Authorization
string
header
required

标准的 HTTP Bearer 认证方式,在 API Keys 页面获取密钥。

Headers

zai-version
enum<string>
default:2026-05-26
required

Managed Agents API 协议版本,固定为 2026-05-26。

Available options:
2026-05-26
Example:

"2026-05-26"

zai-beta
string
default:managed-agents-2026-05-26
required

必须包含 managed-agents-2026-05-26;可与其他 beta 标识用逗号分隔。

Example:

"managed-agents-2026-05-26"

Body

application/json

创建 Environment。config 内出现未支持的字段时请求会被拒绝。

name
string
required

Environment 名称,长度 1–256 个字符。

Required string length: 1 - 256
description
string | null

用途说明;省略或传 null 时不设置。

Maximum string length: 1024
metadata
object

客户端自定义元数据;省略时默认为空对象。最多 16 个键,键名长度不超过 64 字符,值必须是长度不超过 512 字符的字符串。

scope
enum<string> | null
default:organization

公开 API 仅支持 organization;省略或传 null 时也使用 organization。

Available options:
organization
config
object | null

运行环境配置;省略或传 null 时使用 cloud、空 packages、unrestricted networking。

Response

请求成功。

id
string
required

Environment ID。

Example:

"env_019e8f00-1ac2-7a6b-8000-3f2d5c8b9a01"

type
enum<string>
required
Available options:
environment
name
string
required
description
string | null
required

用途说明。

metadata
object
required

客户端自定义元数据;省略时默认为空对象。最多 16 个键,键名长度不超过 64 字符,值必须是长度不超过 512 字符的字符串。

config
object
required
scope
enum<string>
required
Available options:
organization
state
enum<string>
required
Available options:
active,
archived
archived_at
string | null
required

归档时间。

created_at
string<date-time>
required

创建时间。

updated_at
string<date-time>
required

更新时间。