PATCH /admin/cells/{id}

更新 CellSpec（部分更新）。

PATCH /admin/cells/{id}

路径参数

参数	类型	说明
`id`	string	Cell ID

请求参数

只传需要修改的字段。示例——修改语言和配额：

{
  "locale": "en-US",
  "quotas": {
    "max_concurrent_runs": 10,
    "tokens_per_minute": 200000
  }
}

可修改字段（部分列举）：

字段	类型	说明
`locale`	string	语言区域
`compliance`	string	合规预设
`governance`	object	治理配置
`provider_strategy`	string	Provider 策略
`quotas`	object	配额配置
`private_providers`	object[]	Cell 私有 Provider 列表
`allowed_models`	string[]	允许使用的模型列表

不可修改字段（immutable）：

字段	说明
`id`	Cell ID，创建后不可变
`timezone`	时区，创建后不可变

⚠️ 尝试修改 immutable 字段会被静默忽略，不会报错。

curl 示例

修改法务部门 Cell 的并发 Run 限制：

curl -s -X PATCH "http://localhost:9091/admin/cells/dept-legal" \
  -H "Authorization: Bearer $ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "quotas": {
      "max_concurrent_runs": 10
    }
  }' | jq .

响应

200 OK

{
  "ok": true
}

错误码

HTTP	错误	说明
400	—	请求体格式错误
401	—	未认证或 Token 无效
403	—	非 Admin Token
404	—	Cell 不存在
409	`ErrDegradedSecretOverwrite`	降级态密钥冲突（尝试覆盖无法解密的密钥，见 INV-PERSIST-07）

PATCH /admin/cells/{id}

路径参数

请求参数

curl 示例

响应

200 OK

错误码

相关端点