실행 재개

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

베어러 인증

일시 중단된 실행을 재개합니다(예: 휴먼 인 더 루프 승인 후). 프로젝트 범위는 경로 ID 경로 매개 변수에 의해 전달되며 조직은 해당 프로젝트 에서 파생됩니다.

경로 매개변수

id 문자열 필수 사항

프로젝트 ID
execution_id 문자열 필수 사항

실행 ID

쿼리 매개변수

Workspace_id 문자열

작업 공간 확인을 위한 작업 공간 ID

application/json

body 필수 사항

페이로드 재개

결정 문자열 필수 사항
Reviewer_notes 문자열
suspension_generation integer

SuspendGeneration은 검토자에게 표시된 일시 중단 스냅샷 (실행의 일시 중단 생성에서)에 결정 사항을 고정합니다. OE는 현재 일시 중단과 다른 경우 충돌로 인해 이력서를 거부하므로 검토자가 본 적이 없는 검토 콘텐츠에는 승인이 적용되지 않습니다.

최소값은 0입니다.

응답

406

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

지원되지 않거나 잘못된 API 버전, 선택한 게시된 계약에서 사용할 수 없는 작업 또는 허용되지 않는 표현(지원되지 않는 미디어 유형 매개변수 또는 제외된 SSE 포함). 기존 인증, 권한 부여 및 속도 제한 실패가 우선적으로 적용됩니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  HTTP status code.
- 오류 코드 문자열 필수 사항
  
  기계가 읽을 수 있는 오류 코드입니다.
- 매개변수 array[string]
  
  오류와 관련된 요청 매개변수 이름입니다. 적용 않는 경우 생략됩니다.
- 이유 문자열 필수 사항
  
  HTTP 상태 이유 구문입니다.
응답 속성 숨기기 응답 속성 표시 객체
- badRequestDetail 객체
  
  표준 오류 스키마 에 정의된 선택적 유효성 검사 세부 정보입니다. API 협상 오류는 이 필드 내보내지 않습니다.
  
  badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
  
  필드 배열[객체]
  
  유효성 검사 에 실패한 필드입니다.
  
  필드 속성 숨기기 필드 속성 표시 객체
  
  필드 및 해당 유효성 검사 실패.
  
  description 문자열 필수 사항
  
  사람이 읽을 수 있는 유효성 검사 실패.
  
  필드 문자열 필수 사항
  
  잘못된 요청 필드 의 이름 또는 경로입니다.
- 세부 정보 문자열 필수 사항
  
  사람이 읽을 수 있는 오류 세부 정보.
- 오류 integer 필수 사항
  
  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

잘못된 요청
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- Success 부울
401

application/json

application/json 애플리케이션/vnd.agent-engine-2026-09-20-preview+json

승인되지 않음
응답 속성 숨기기 응답 속성 표시 객체
- 코드 문자열
- 오류 문자열
- 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_action_at 문자열
응답 속성 숨기기 응답 속성 표시 객체
- blocking_execution_id 문자열
- blocking_status 문자열
- 코드 문자열
- 오류 문자열
- last_action_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, AGENT_STARTUP_FAILED/STARTUP_FAILED 스타트업 실패의 경우 StartupFailureResponse 또는 워크플로 분기 활성화 실패의 경우 ErrorResponse
다음 중 하나:
ResumeExecutionResponse 객체 StartupFailureResponse 객체 ErrorResponse 객체
속성 숨기기 속성 표시

오류 문자열

execution_id 문자열

상태 문자열

Success 부울
속성 숨기기 속성 표시

Boot_id 문자열

코드 문자열

구성 요소 문자열

Component는 레거시 내부 구성 요소 이름(aer, 도구, 플랫폼)입니다.

오류 문자열

execution_id 문자열

sandbox 문자열

샌드박스는 알려진 구성 요소의 표준 공개 샌드박스 이름입니다.

source 문자열

Success 부울
속성 숨기기 속성 표시

코드 문자열

오류 문자열

Success 부울
다음 중 하나:
ResumeExecutionResponse 객체 StartupFailureResponse 객체 ErrorResponse 객체
속성 숨기기 속성 표시

오류 문자열

execution_id 문자열

상태 문자열

Success 부울
속성 숨기기 속성 표시

Boot_id 문자열

코드 문자열

구성 요소 문자열

Component는 레거시 내부 구성 요소 이름(aer, 도구, 플랫폼)입니다.

오류 문자열

execution_id 문자열

sandbox 문자열

샌드박스는 알려진 구성 요소의 표준 공개 샌드박스 이름입니다.

source 문자열

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, 도구, 플랫폼)입니다.

오류 문자열

execution_id 문자열

sandbox 문자열

샌드박스는 알려진 구성 요소의 표준 공개 샌드박스 이름입니다.

source 문자열

Success 부울
속성 숨기기 속성 표시

코드 문자열

오류 문자열

Success 부울
다음 중 하나:
StartupFailureResponse 객체 ErrorResponse 객체
속성 숨기기 속성 표시

Boot_id 문자열

코드 문자열

구성 요소 문자열

Component는 레거시 내부 구성 요소 이름(aer, 도구, 플랫폼)입니다.

오류 문자열

execution_id 문자열

sandbox 문자열

샌드박스는 알려진 구성 요소의 표준 공개 샌드박스 이름입니다.

source 문자열

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
}