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

Resumes a suspended execution (e.g., after human-in-the-loop approval). The project scope is carried by the route id path parameter and the org is derived from that project.

Path parameters

  • id string Required

    Project ID

  • execution_id string Required

    Execution ID

Query parameters

  • workspace_id string

    Workspace ID for workspace resolution

application/json

Body Required

Resume payload

  • decision string Required
  • reviewer_notes string
  • suspend_generation integer

    SuspendGeneration pins the decision to the suspension snapshot the reviewer was shown (from the execution's suspend_generation). OE rejects the resume with a conflict when the current suspension differs, so an approval is never applied to review content the reviewer never saw.

    Minimum value is 0.

Responses

  • 406

    Unsupported or malformed API version, an operation unavailable in the selected published contract, or an unacceptable representation (including unsupported media-type parameters or excluded SSE). Existing authentication, authorization, and rate-limit failures take precedence.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Fields with validation failures.

        Hide fields attributes Show fields attributes object

        A field and its validation failure.

        • description string Required

          Human-readable validation failure.

        • field string Required

          Name or path of the invalid request field.

    • detail string Required

      Human-readable error details.

    • error integer Required

      HTTP status code.

    • errorCode string Required

      Machine-readable error code.

    • parameters array[string]

      Request parameter names associated with the error; omitted when none apply.

    • reason string Required

      HTTP status reason phrase.

    Hide response attributes Show response attributes object
    • badRequestDetail object

      Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

      Hide badRequestDetail attribute Show badRequestDetail attribute object
      • fields array[object]

        Fields with validation failures.

        Hide fields attributes Show fields attributes object

        A field and its validation failure.

        • description string Required

          Human-readable validation failure.

        • field string Required

          Name or path of the invalid request field.

    • detail string Required

      Human-readable error details.

    • error integer Required

      HTTP status code.

    • errorCode string Required

      Machine-readable error code.

    • parameters array[string]

      Request parameter names associated with the error; omitted when none apply.

    • reason string Required

      HTTP status reason phrase.
  • 200

    OK

    Hide response attributes Show response attributes object
    • error string
    • execution_id string
    • status string
    • success boolean
    Hide response attributes Show response attributes object
    • error string
    • execution_id string
    • status string
    • success boolean
  • 400

    Bad Request

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 401

    Unauthorized

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 404

    Not Found

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 409

    Conflict

    Hide response attributes Show response attributes object
    • blocking_execution_id string
    • blocking_status string
    • code string
    • error string
    • last_activity_at string
    Hide response attributes Show response attributes object
    • blocking_execution_id string
    • blocking_status string
    • code string
    • error string
    • last_activity_at string
  • 422

    PROJECT_SECRET_INVALID: the workspace cannot start because a project secret is invalid or unreachable (fix the secret and redeploy)

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
  • 500

    ResumeExecutionResponse, StartupFailureResponse for an AGENT_STARTUP_FAILED/STARTUP_FAILED startup failure, or ErrorResponse for a workflow-branch activation failure

    Any of:
    ResumeExecutionResponse object StartupFailureResponse object ErrorResponse object
    Any of:
    ResumeExecutionResponse object StartupFailureResponse object ErrorResponse object
  • 502

    Bad Gateway

    Hide response attributes Show response attributes object
    • error string
    • execution_id string
    • status string
    • success boolean
    Hide response attributes Show response attributes object
    • error string
    • execution_id string
    • status string
    • success boolean
  • 503

    StartupFailureResponse for a POOL_EXHAUSTED/EXECUTOR_BOOT_FAILED/PLATFORM_DEPENDENCY_FAILED/POOL_UNREACHABLE startup failure; ErrorResponse otherwise. POOL_EXHAUSTED carries a Retry-After header

    Hide headers attribute Show headers attribute
    • Retry-After string

      Seconds to wait before retrying (POOL_EXHAUSTED only)

    Any of:
    StartupFailureResponse object ErrorResponse object
    Any of:
    StartupFailureResponse object ErrorResponse object
  • 504

    Gateway Timeout

    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
    Hide response attributes Show response attributes object
    • code string
    • error string
    • success boolean
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
}'
Request examples 
{
  "decision": "approved",
  "reviewer_notes": "Reviewed and approved.",
  "suspend_generation": 1
}
Response examples (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"
}
Response examples (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"
}
Response examples (200) 
{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}
Response examples (200) 
{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}
Response examples (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (400) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (401) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (404) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (409) 
{
  "blocking_execution_id": "string",
  "blocking_status": "string",
  "code": "string",
  "error": "string",
  "last_activity_at": "string"
}
Response examples (409) 
{
  "blocking_execution_id": "string",
  "blocking_status": "string",
  "code": "string",
  "error": "string",
  "last_activity_at": "string"
}
Response examples (422) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (422) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (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
}
Response examples (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
}
Response examples (502) 
{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}
Response examples (502) 
{
  "error": "string",
  "execution_id": "string",
  "status": "string",
  "success": true
}
Response examples (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
}
Response examples (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
}
Response examples (504) 
{
  "code": "string",
  "error": "string",
  "success": true
}
Response examples (504) 
{
  "code": "string",
  "error": "string",
  "success": true
}