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

# How alerting works

> How a rule in the catalogue becomes a live alert, targeting accounts, setting thresholds, and routing notifications.

The catalogue tells you **what** each rule detects. This page covers **how** you
turn one on and where the alerts go.

## The shape of an alert

A live alert is a rule, pointed at specific accounts, with the thresholds and
destinations you choose:

<Steps>
  <Step title="Pick a rule">
    Browse the [catalogue](/alerting/introduction) and choose a rule that matches
    what you want to watch, a multisig, a treasury wallet, a token, a program.
  </Step>

  <Step title="Point it at your accounts">
    Configure the rule against the accounts, contracts, or assets you care about.
    The same rule can be applied to many targets.
  </Step>

  <Step title="Set your thresholds">
    Most rules take parameters, USD minimums, time windows, allow-lists, risk-score
    cut-offs. These are yours to set per rule instance; the catalogue lists what's
    configurable under each rule's **Trigger condition**.
  </Step>

  <Step title="Choose where alerts go">
    Route the alert to any destination your workspace has connected. See
    [Supported destinations](/alerting/supported-destinations).
  </Step>
</Steps>

## Configure in the dashboard or via the API

You can manage rules two ways:

<CardGroup cols={2}>
  <Card title="Range platform" icon="browser" href="https://app.range.org">
    Turn rules on, set thresholds, and connect destinations from the Range
    dashboard, no code required.
  </Card>

  <Card title="Alerting API" icon="code" href="/platform-api/platform-introduction">
    Manage alert rules programmatically through the Platform API, list available
    rules, create rule instances against your accounts, and keep them in sync with
    your own tooling.
  </Card>
</CardGroup>

<Note>
  The alerting endpoints live under the [Platform API](/platform-api/platform-introduction),
  alongside accounts, counterparties, and connections, so the accounts you monitor
  and the rules that watch them share one API surface and one API key.
</Note>

## Severity is yours to set

Rules don't ship with a fixed severity. You decide how urgent each alert is for
your workspace when you configure it, and some rules can escalate at runtime based
on context (for example, the USD value moved or a counterparty's risk score).