# Resume execution

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

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.


## Servers
- https://agentengine.mongodb.com: https://agentengine.mongodb.com ()


## Authentication methods
- Bearer auth


## Parameters

### Path parameters

- **id** (string)
  Project ID

- **execution_id** (string)
  Execution ID


### Query parameters

- **workspace_id** (string)
  Workspace ID for workspace resolution


### Body: application/json (object)
Resume payload
- **decision** (string)

- **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.



## 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.

#### Body: application/json (object)
- **badRequestDetail** (object)
  Optional validation details defined by the standard error schema; API negotiation errors do not emit this field.

- **detail** (string)
  Human-readable error details.

- **error** (integer)
  HTTP status code.

- **errorCode** (string)
  Machine-readable error code.

- **parameters** (array[string])
  Request parameter names associated with the error; omitted when none apply.

- **reason** (string)
  HTTP status reason phrase.


### 200
OK

#### Body: application/json (object)
- **error** (string)

- **execution_id** (string)

- **status** (string)

- **success** (boolean)


### 400
Bad Request

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 401
Unauthorized

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 404
Not Found

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)


### 409
Conflict

#### Body: application/json (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)

#### Body: application/json (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

#### Body: application/json (object)
- **error** (string)

- **execution_id** (string)

- **status** (string)

- **success** (boolean)


### 502
Bad Gateway

#### Body: application/json (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
#### Headers

- **Retry-After** (string)
  Seconds to wait before retrying (POOL_EXHAUSTED only)


#### Body: application/json (object)
- **boot_id** (string)

- **code** (string)

- **component** (string)
  Component is the legacy internal component name (aer, tool, platform).

- **error** (string)

- **execution_id** (string)

- **sandbox** (string)
  Sandbox is the canonical public sandbox name for known components.

- **source** (string)

- **success** (boolean)


### 504
Gateway Timeout

#### Body: application/json (object)
- **code** (string)

- **error** (string)

- **success** (boolean)



[Powered by Bump.sh](https://bump.sh)