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

# monid runs stop

> Stop a queued or running run.

Stop a run that is `READY` or `RUNNING`. Terminal runs (`COMPLETED`, `FAILED`, `BLOCKED`, `STOPPED`, `TIMED_OUT`) cannot be stopped, and endpoints that are not stoppable are rejected with a `409`.

Stopping is asynchronous: the command is acknowledged with status `STOPPING`, and the run then settles to a terminal status. Use [`monid runs get`](/docs/cli/runs/get) to confirm the final state.

## Usage

```bash theme={null}
monid runs stop -r <run-id> [--json]
```

## Flags

| Flag                   | Type    | Required | Description        |
| ---------------------- | ------- | -------- | ------------------ |
| `-r, --run-id <runId>` | string  | Yes      | The run ID to stop |
| `-j, --json`           | boolean | No       | Output raw JSON    |

## Examples

```bash theme={null}
monid runs stop -r 01HXYZ...
```

<Note>
  The settlement depends on the endpoint's pricing model: runs on **metered** endpoints bill for the usage accrued before the stop and settle as `COMPLETED`; all other stopped runs settle as `STOPPED` and are zero-billed.
</Note>