# Interrupt an in-flight tool or LLM call

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

Aborts in-flight tool or LLM calls for an execution without canceling the session, so the agent continues. Send step_number to interrupt a single named call; omit the body to interrupt every call currently in flight. The response's outcome reports exactly what happened: "aborted" (something in flight was stopped), "armed" (nothing in flight; armed for the execution's next call, pending=true), "already_armed" (an unexpired arm already existed; the TTL was not extended), "noop_terminal" (the execution is already terminal, possibly on another replica), "in_flight_elsewhere" (the durable step record shows the call in flight but not on this OE replica; nothing was aborted here, and a backstop scoped to the stamped steps stops the call at dispatch if that dispatch completes on this replica — it can never trap a later call), or "noop" (a named step_number matched nothing in flight). Idempotent: repeated requests are safe.


## 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 that owns the execution, needed to route the interrupt to that workspace's OE


### Body: application/json (object)
Optional single-call target
- **step_number** (integer)
  StepNumber is the execution step of the single tool/LLM call to interrupt.



## 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)
object
### 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)
object
### 413
Request Entity Too Large

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

- **error** (string)

- **success** (boolean)


### 502
Bad Gateway

#### Body: application/json (object)
object

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