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

# Cancelling a Run

> Cancel running agent, team, or workflow executions.

Run cancellation provides the ability to stop running agent, team, or workflow executions. This feature is useful for managing long-running operations, implementing timeouts, or allowing users to interrupt processes.

## How It Works

The `cancel_run()` function records cancellation intent for a run. Agent, team, and workflow runs stop when they reach the next cooperative cancellation checkpoint. An operation already in progress may finish, and cancellation does not roll back external side effects.

**Cancellation Behavior:**

* **Non-Streaming Runs**: The `RunOutput` object is returned with status set to `RunStatus.cancelled`.
* **Streaming Runs**: A `RunCancelledEvent` is emitted when cancellation occurs. Workflows emit a `WorkflowCancelledEvent`.

## Cancellation Methods

<CardGroup cols={3}>
  <Card title="Agent Run Cancellation" icon="user-astronaut" iconType="duotone" href="/run-cancellation/agent-cancel-run">
    Cancel agent runs programmatically or via API endpoints.
  </Card>

  <Card title="Team Run Cancellation" icon="users" iconType="duotone" href="/run-cancellation/team-cancel-run">
    Cancel team runs and handle member run cancellations.
  </Card>

  <Card title="Workflow Run Cancellation" icon="diagram-project" iconType="duotone" href="/run-cancellation/workflow-cancel-run">
    Cancel workflow executions and manage step-level cancellation.
  </Card>
</CardGroup>