恢复执行

发布 /api/v1/projects/{id}/executions/{execution_id}/resume

持有者身份验证

恢复暂停的执行（例如，在人工参与批准后）。项目范围由路由 ID 路径参数承载，而组织则派生自该项目。

路径参数

id 字符串必需

项目 ID
execution_id 字符串必需

执行ID

查询参数

Workspace_id 字符串

用于工作区解析的工作区ID

application/json

body 必需

恢复有效负载

决定字符串必需
reviewer_notes 字符串
Suspend_Generation 整型

SuspendGeneration 将决策固定到向审阅者显示的暂停快照（来自执行的 minate_Generation）。当当前暂停不同时，OE 会拒绝存在冲突的恢复，因此批准永远不会应用于审核者从未见过的查看内容。

最小值为 0。

响应

406

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

不支持或格式不正确的API版本、所选已发布合约中不可用的操作或不可接受的表示形式（包括不支持的媒体类型参数或排除的 SSE）。现有的身份验证、授权和速率限制失败优先。
隐藏响应属性显示响应属性对象
- badRequestDetail 对象
  
  标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。
  
  隐藏 BadRequestDetail 属性显示 BadRequestDetail 属性对象
  
  字段大量[对象]
  
  验证失败的字段。
  
  隐藏字段属性显示字段属性对象
  
  字段及其验证失败。
  
  描述字符串必需
  
  人类可读的验证失败。
  
  字段字符串必需
  
  无效请求字段的名称或路径。
- 详细信息字符串必需
  
  人类可读的错误详细信息。
- 错误整型必需
  
  HTTP status code.
- 错误代码字符串必需
  
  机器可读的错误代码。
- 参数 array[string]
  
  与错误相关的请求参数名称；不应用时省略。
- 原因字符串必需
  
  HTTP状态原因短语。
隐藏响应属性显示响应属性对象
- badRequestDetail 对象
  
  标准错误模式定义的可选验证详细信息； API协商错误不会发出此字段。
  
  隐藏 BadRequestDetail 属性显示 BadRequestDetail 属性对象
  
  字段大量[对象]
  
  验证失败的字段。
  
  隐藏字段属性显示字段属性对象
  
  字段及其验证失败。
  
  描述字符串必需
  
  人类可读的验证失败。
  
  字段字符串必需
  
  无效请求字段的名称或路径。
- 详细信息字符串必需
  
  人类可读的错误详细信息。
- 错误整型必需
  
  HTTP status code.
- 错误代码字符串必需
  
  机器可读的错误代码。
- 参数 array[string]
  
  与错误相关的请求参数名称；不应用时省略。
- 原因字符串必需
  
  HTTP状态原因短语。
200

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

正常
隐藏响应属性显示响应属性对象
- 错误字符串
- execution_id 字符串
- 状态字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 错误字符串
- execution_id 字符串
- 状态字符串
- Success 布尔
400

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

Bad Request
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
401

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

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

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

未找到
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
409

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

冲突
隐藏响应属性显示响应属性对象
- blocking_execution_id 字符串
- blocking_status 字符串
- 代码字符串
- 错误字符串
- last_activity_at 字符串
隐藏响应属性显示响应属性对象
- blocking_execution_id 字符串
- blocking_status 字符串
- 代码字符串
- 错误字符串
- last_activity_at 字符串
第 422 章

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

PROJECT_SECRET_INVALID：工作区无法启动，因为项目密钥无效或无法访问（修复密钥并重新部署）
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
500

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

ResumeExecutionResponse、StartupFailureResponse（针对 AGENT_STARTUP_FAILED/STARTUP_FAILED初创企业失败）或 ErrorResponse（针对工作流分支激活失败）
以下任何一项：
ResumeExecutionResponse对象 StartupFailureResponse对象 ErrorResponse对象
隐藏属性显示属性

错误字符串

execution_id 字符串

状态字符串

Success 布尔
隐藏属性显示属性

boot_id 字符串

代码字符串

组件字符串

Component 是旧版内部组件名称（aer、tool、platform）。

错误字符串

execution_id 字符串

sandbox 字符串

Sandbox 是已知组件的规范公共沙箱名称。

来源字符串

Success 布尔
隐藏属性显示属性

代码字符串

错误字符串

Success 布尔
以下任何一项：
ResumeExecutionResponse对象 StartupFailureResponse对象 ErrorResponse对象
隐藏属性显示属性

错误字符串

execution_id 字符串

状态字符串

Success 布尔
隐藏属性显示属性

boot_id 字符串

代码字符串

组件字符串

Component 是旧版内部组件名称（aer、tool、platform）。

错误字符串

execution_id 字符串

sandbox 字符串

Sandbox 是已知组件的规范公共沙箱名称。

来源字符串

Success 布尔
隐藏属性显示属性

代码字符串

错误字符串

Success 布尔
502

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

错误网关
隐藏响应属性显示响应属性对象
- 错误字符串
- execution_id 字符串
- 状态字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 错误字符串
- execution_id 字符串
- 状态字符串
- Success 布尔
503

应用程序/vnd.agent-engine-2026-09-20-preview+json

应用程序/vnd.agent-engine-2026-09-20-preview+json application/json

针对 POOL_EXHAUSTED/EXECUTOR_BOOT_FAILED/PLATFORM_DEPENDENCY_FAILED/POOL_UNREACHABLE初创企业失败的 StartupFailureResponse；否则为 ErrorResponse。 POOL_EXHAUSTED 带有 Retry-After 标头
隐藏标头属性显示标头属性
- 重试后字符串
  
  重试前等待的秒数（仅限 POOL_EXHAUSTED）
以下任何一项：
StartupFailureResponse对象 ErrorResponse对象
隐藏属性显示属性

boot_id 字符串

代码字符串

组件字符串

Component 是旧版内部组件名称（aer、tool、platform）。

错误字符串

execution_id 字符串

sandbox 字符串

Sandbox 是已知组件的规范公共沙箱名称。

来源字符串

Success 布尔
隐藏属性显示属性

代码字符串

错误字符串

Success 布尔
以下任何一项：
StartupFailureResponse对象 ErrorResponse对象
隐藏属性显示属性

boot_id 字符串

代码字符串

组件字符串

Component 是旧版内部组件名称（aer、tool、platform）。

错误字符串

execution_id 字符串

sandbox 字符串

Sandbox 是已知组件的规范公共沙箱名称。

来源字符串

Success 布尔
隐藏属性显示属性

代码字符串

错误字符串

Success 布尔
504

application/json

application/json 应用程序/vnd.agent-engine-2026-09-20-preview+json

网关超时
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔
隐藏响应属性显示响应属性对象
- 代码字符串
- 错误字符串
- Success 布尔

POST /api/v1/projects/{id}/executions/{execution_id}/resume

curl \
 --request POST 'https://agentengine.mongodb.com/api/v1/projects/{id}/executions/{execution_id}/resume' \
 --header "Authorization: $API_KEY" \
 --header "Content-Type: application/json" \
 --data '{
  "decision": "approved",
  "reviewer_notes": "Reviewed and approved.",
  "suspend_generation": 1
}'

请求示例

{
  "decision": "approved",
  "reviewer_notes": "Reviewed and approved.",
  "suspend_generation": 1
}

响应示例 (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)

{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}

响应示例 (200)

{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}

响应示例 (400)

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

响应示例 (400)

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

响应示例 (401)

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

响应示例 (401)

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

响应示例 (404)

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

响应示例 (404)

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

响应示例 (409)

{
  "blocking_execution_id": "string",
  "blocking_status": "string",
  "code": "string",
  "error": "string",
  "last_activity_at": "string"
}

响应示例 (409)

{
  "blocking_execution_id": "string",
  "blocking_status": "string",
  "code": "string",
  "error": "string",
  "last_activity_at": "string"
}

响应示例 (422)

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

响应示例 (422)

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

响应示例 (500)

{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}

{
  "boot_id": "string",
  "code": "string",
  "component": "string",
  "error": "string",
  "execution_id": "string",
  "sandbox": "string",
  "source": "string",
  "success": true
}

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

响应示例 (500)

{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}

{
  "boot_id": "string",
  "code": "string",
  "component": "string",
  "error": "string",
  "execution_id": "string",
  "sandbox": "string",
  "source": "string",
  "success": true
}

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

响应示例 (502)

{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}

响应示例 (502)

{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}

响应示例 (503)

# Headers
Retry-After: string

# Payload
{
  "boot_id": "string",
  "code": "string",
  "component": "string",
  "error": "string",
  "execution_id": "string",
  "sandbox": "string",
  "source": "string",
  "success": true
}

# Headers
Retry-After: string

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

响应示例 (503)

# Headers
Retry-After: string

# Payload
{
  "boot_id": "string",
  "code": "string",
  "component": "string",
  "error": "string",
  "execution_id": "string",
  "sandbox": "string",
  "source": "string",
  "success": true
}

# Headers
Retry-After: string

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

响应示例 (504)

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

响应示例 (504)

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