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

# Stop a run

> Cancel the message in progress

Stops the message the agent is working on, like the stop button on rhizomeai.com. The stopped message is removed from the conversation, along with any documents it produced, and is not counted against your plan. The conversation can be continued with a new message.

`stopped: false` means there was nothing to stop: the run had already finished, and its answer stands.

## Path parameters

<ParamField path="conversation_id" type="string" required>
  The conversation's id.
</ParamField>

## Response

<ResponseField name="conversation_id" type="string">
  The conversation's id.
</ResponseField>

<ResponseField name="stopped" type="boolean">
  Whether a run was stopped.
</ResponseField>

## Errors

| Status | Code | Description |
| - | - | - |
| 404 | `not_found` | No conversation with this id in your account |

Plus `401` and `429`, see [Errors](/api-reference/v3/conversations/overview#errors).

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST https://rhizomeai.com/api/v3/conversations/3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01/stop \
    -H "x-api-key: YOUR_API_KEY"
  ```

  ```python Python theme={null}
  import requests

  conversation_id = "3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01"
  response = requests.post(
      f"https://rhizomeai.com/api/v3/conversations/{conversation_id}/stop",
      headers={"x-api-key": "YOUR_API_KEY"},
  )
  response.raise_for_status()
  print(response.json()["stopped"])
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "conversation_id": "3b1f8c6e-2a4d-4c1e-9f2a-7d5e6b8c9a01",
    "stopped": true
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.