> ## Documentation Index
> Fetch the complete documentation index at: https://monid.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Stop Run

> Stop a running run.

```text theme={null}
POST /v1/runs/:runId/stop
```

Stop a run that is `READY` or `RUNNING`. Terminal runs (`COMPLETED`, `FAILED`) cannot be stopped.

## Headers

| Header           | Required | Description                                                          |
| ---------------- | -------- | -------------------------------------------------------------------- |
| `Authorization`  | Yes      | `Bearer <api-key>`                                                   |
| `x-workspace-id` | Yes      | Workspace ID — see [`GET /v1/auth/workspaces`](/api/auth/workspaces) |

## Path Parameters

| Parameter | Type   | Description        |
| --------- | ------ | ------------------ |
| `runId`   | string | The run ID to stop |

## Example Request

<CodeGroup>
  ```bash curl theme={null}
  curl -X POST "https://api.monid.ai/v1/runs/01HXYZ1234567890ABCDEF/stop" \
    -H "Authorization: Bearer monid_live_..." \
    -H "x-workspace-id: ws_abc123"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    "https://api.monid.ai/v1/runs/01HXYZ1234567890ABCDEF/stop",
    {
      method: "POST",
      headers: {
        Authorization: "Bearer monid_live_...",
        "x-workspace-id": "ws_abc123",
      },
    },
  );
  ```
</CodeGroup>

## 200 OK

Returns the run in its updated state.

```json theme={null}
{
  "runId": "01HXYZ1234567890ABCDEF",
  "status": "FAILED",
  "completedAt": "2026-03-28T10:30:45.000Z"
}
```

<Note>
  Stopped runs settle as `FAILED`. Any partial charges incurred before the stop are still applied.
</Note>