修补 /api/v1/projects/{id}/workspaces/{workspace_id}
持有者身份验证

部分更新工作区。项目范围由路由 ID 路径参数承载。仅限字段的补丁返回 204；仅状态补丁（暂停/恢复）与其他字段互斥，并返回带有 ECP 的应用主体的 200（包括任何 warnings）。

路径参数

  • id 字符串 必需

    项目 ID

  • Workspace_id 字符串 必需

    工作区ID

application/json

body 必需

要更新的字段

  • Agent_card 对象
    隐藏 Agent_card 属性 显示agent_card 属性 对象
    • a2a_allowed_callers array[string]

      2AAllowedCallers 限制哪些工作区 ID 可以通过 A2A 调用此代理。空列表表示允许任何调用者。

    • a2a_enabled 布尔

      A2AEnabled 控制此代理是否可供 A2A 调用发现。

    • 能力 array[string]
    • input_modes array[string]

      InputModes 列出代理接受的MIME类型（例如“text/plain”、 “应用程序/json”）。

    • output_modes array[string]

      OutputModes 列出了代理可以生成的MIME类型。

    • 技能 大量[对象]

      技能公布了代理可以执行的离散任务。

      隐藏技能属性 显示技能属性 对象
      • 描述 字符串
      • example_input 字符串
      • example_output 字符串
      • 名称 字符串
    • 总结 字符串
  • auto_deploy 布尔

    AutoDeploy 是应用级 ECP字段（不会持久保存在网关数据库中）；逐字转发到 ECP 的应用PATCH。

  • 描述 字符串
  • 功能 对象
    隐藏要素属性 显示要素属性 对象
    • 护栏 布尔
    • 内存 布尔
    • 操场 布尔

      Playground 报告是否为工作区预配了 Playground用户界面（nil/true = 已预配，当前行为）。如果为 false，则调用者会直接使用调用API 。

    • use_custom_parser 布尔

      UseCustomParser 如果为 true，则使网关在调用流上仅发出代理的输出解析器自定义事件（删除平台框架）。从 AgentEngine 初始化时的代理.yaml 功能中保留。

  • 框架 字符串
  • gitops 对象
    隐藏 gitops 属性 显示 gitops 属性 对象
    • 分支 字符串
    • connection_ref 字符串
    • manifest_path 字符串
    • provider 字符串
    • repo_url 字符串
  • 名称 字符串
  • release_mode 字符串

    ReleaseMode 是应用级 ECP字段（不会持久保存在网关数据库中）；逐字转发到 ECP 的应用PATCH。仅控制 Webhook 触发的构建 — API触发的发布在每种模式下都可用。

  • 状态 字符串

    状态是暂停/恢复信号(“活动”|“暂停”)。网关不会将其持久保存在本地；处理程序将仅状态补丁直接转发到 ECP，而 ECP 会运行 Pause-teardown/resume-redeploy。

  • 子目录 字符串
  • Workspace_name 字符串

响应

  • 406

    不支持或格式不正确的API版本、所选已发布合约中不可用的操作或不可接受的表示形式（包括不支持的媒体类型参数或排除的 SSE）。现有的身份验证、授权和速率限制失败优先。

    隐藏响应属性 显示响应属性 对象
    • badRequestDetail 对象

      标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。

      隐藏 BadRequestDetail 属性 显示 BadRequestDetail 属性 对象
      • 字段 大量[对象]

        验证失败的字段。

        隐藏字段属性 显示字段属性 对象

        字段及其验证失败。

        • 描述 字符串 必需

          人类可读的验证失败。

        • 字段 字符串 必需

          无效请求字段的名称或路径。

    • 详细信息 字符串 必需

      人类可读的错误详细信息。

    • 错误 整型 必需

      HTTP status code.

    • 错误代码 字符串 必需

      机器可读的错误代码。

    • 参数 array[string]

      与错误相关的请求参数名称；不应用时省略。

    • 原因 字符串 必需

      HTTP状态原因短语。

    隐藏响应属性 显示响应属性 对象
    • badRequestDetail 对象

      标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。

      隐藏 BadRequestDetail 属性 显示 BadRequestDetail 属性 对象
      • 字段 大量[对象]

        验证失败的字段。

        隐藏字段属性 显示字段属性 对象

        字段及其验证失败。

        • 描述 字符串 必需

          人类可读的验证失败。

        • 字段 字符串 必需

          无效请求字段的名称或路径。

    • 详细信息 字符串 必需

      人类可读的错误详细信息。

    • 错误 整型 必需

      HTTP status code.

    • 错误代码 字符串 必需

      机器可读的错误代码。

    • 参数 array[string]

      与错误相关的请求参数名称；不应用时省略。

    • 原因 字符串 必需

      HTTP状态原因短语。
  • 200

    针对仅状态补丁返回；从 ECP 代理。

    隐藏响应属性 显示响应属性 对象
    • app_id 字符串
    • org_id 字符串
    • PROJECT_ID 字符串
    • 状态 字符串
    • 警告 array[string]
    隐藏响应属性 显示响应属性 对象
    • app_id 字符串
    • org_id 字符串
    • PROJECT_ID 字符串
    • 状态 字符串
    • 警告 array[string]
  • 204

    针对字段更新补丁返回。

  • 400

    Bad Request

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 404

    未找到

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 413

    请求实体太大

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 429

    请求过多

    隐藏标头属性 显示标头属性
    • 重试后 字符串

      重试前等待的秒数

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 500

    内部服务器错误

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 502

    ECP 传输或暂停-拆除失败。

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
  • 503

    服务不可用

    隐藏标头属性 显示标头属性
    • 重试后 字符串

      重试前等待的秒数

    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
    隐藏响应属性 显示响应属性 对象
    • 代码 字符串
    • 错误 字符串
    • Success 布尔
PATCH /api/v1/projects/{id}/workspaces/{workspace_id} 
curl \
 --request PATCH 'https://agentengine.mongodb.com/api/v1/projects/{id}/workspaces/{workspace_id}' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "agent_card": {
    "a2a_allowed_callers": [
      "string"
    ],
    "a2a_enabled": true,
    "capabilities": [
      "string"
    ],
    "input_modes": [
      "string"
    ],
    "output_modes": [
      "string"
    ],
    "skills": [
      {
        "description": "string",
        "example_input": "string",
        "example_output": "string",
        "name": "string"
      }
    ],
    "summary": "string"
  },
  "auto_deploy": true,
  "description": "string",
  "features": {
    "guardrails": true,
    "memory": true,
    "playground": true,
    "use_custom_parser": true
  },
  "framework": "string",
  "gitops": {
    "branch": "string",
    "connection_ref": "string",
    "manifest_path": "string",
    "provider": "string",
    "repo_url": "string"
  },
  "name": "string",
  "release_mode": "string",
  "status": "string",
  "subdirectory": "string",
  "workspace_name": "string"
}'
请求示例 
{
  "agent_card": {
    "a2a_allowed_callers": [
      "string"
    ],
    "a2a_enabled": true,
    "capabilities": [
      "string"
    ],
    "input_modes": [
      "string"
    ],
    "output_modes": [
      "string"
    ],
    "skills": [
      {
        "description": "string",
        "example_input": "string",
        "example_output": "string",
        "name": "string"
      }
    ],
    "summary": "string"
  },
  "auto_deploy": true,
  "description": "string",
  "features": {
    "guardrails": true,
    "memory": true,
    "playground": true,
    "use_custom_parser": true
  },
  "framework": "string",
  "gitops": {
    "branch": "string",
    "connection_ref": "string",
    "manifest_path": "string",
    "provider": "string",
    "repo_url": "string"
  },
  "name": "string",
  "release_mode": "string",
  "status": "string",
  "subdirectory": "string",
  "workspace_name": "string"
}
响应示例 (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "This operation supports text/event-stream, which the Accept header excludes. Remove unsupported media-type parameters or accept this type with a positive q value.",
  "error": 406,
  "errorCode": "UNACCEPTABLE_MEDIA_TYPE",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
{
  "detail": "The requested API version is not supported. Supported versions: 2026-09-20-preview.",
  "error": 406,
  "errorCode": "UNSUPPORTED_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
响应示例 (406) 
{
  "detail": "This operation is not available in API version 2026-09-20-preview.",
  "error": 406,
  "errorCode": "OPERATION_NOT_IN_API_VERSION",
  "parameters": [
    "Accept"
  ],
  "reason": "Not Acceptable"
}
响应示例 (200) 
{
  "app_id": "string",
  "org_id": "string",
  "project_id": "string",
  "status": "active",
  "warnings": [
    "string"
  ]
}
响应示例 (200) 
{
  "app_id": "string",
  "org_id": "string",
  "project_id": "string",
  "status": "active",
  "warnings": [
    "string"
  ]
}
响应示例 (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (413) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (429) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (429) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (500) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (502) 
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (503) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}
响应示例 (503) 
# Headers
Retry-After: string

# Payload
{
  "code": "string",
  "error": "string",
  "success": true
}