# Forwarding Rules

> What a call forwarding rule is, every setting it has, and the defaults Edesy uses for a new rule.

Source: https://edesy.in/docs/call-forwarding/rules

A forwarding rule is the setup for one virtual number: the phones to ring, how they ring, the caller ID your team sees, whether they must press a key to accept, and what the caller hears while waiting. Each number has one rule, and every setting has a sensible default, so a new rule needs only the forward-to numbers.

## Settings and defaults

| Setting | Options | Default | API field |
|---|---|---|---|
| Forward-to numbers | Up to 5, Indian mobile or landline, each with an optional label | Required | `targets` |
| Ring strategy | Ring all at once, or one by one | Ring all at once | `strategy` |
| Ring time | 5 to 120 seconds | 25 | `ring_timeout_sec` |
| Ring time per number (one by one) | 5 to 120 seconds | Rule's ring time | `targets[].ring_timeout` |
| Caller ID shown | Virtual number, or original caller | Virtual number | `caller_id_mode` |
| Press a key to accept | On or off | On | `confirm_required` |
| Connect only when the destination picks up | On or off | On | `answer_on_bridge` |
| Hold audio | Off, built-in "please hold", or your clip | Off | `hold_audio_enabled` |
| Sticky agent (ring one by one) | On or off, window 1 to 8,760 hours | Off (168 hours when on) | `sticky_enabled`, `sticky_window_hours` |
| Status | Active or paused | Active | `status` |

## Where to change them

- **forwarding.edesy.in:** open the number under **Forwarding Numbers**. Number, label, forward-to list, strategy, ring time, caller ID, screening, connect on pickup and hold audio are all on the edit page.
- **voice-app.edesy.in:** the **Call handling** card on a number's page also sets per-number ring times and sticky agent.
- **API:** every setting, with `PATCH /v1/forwarding/rules/:id`. See [Rules API](https://edesy.in/docs/call-forwarding/api/rules).

## Pages in this section

- [Ring Strategies](https://edesy.in/docs/call-forwarding/rules/ring-strategies)
- [Ring Time and Fallback](https://edesy.in/docs/call-forwarding/rules/ring-time-and-fallback)
- [Caller ID Display](https://edesy.in/docs/call-forwarding/rules/caller-id-display)
- [Call Screening](https://edesy.in/docs/call-forwarding/rules/call-screening)
- [Hold Music](https://edesy.in/docs/call-forwarding/rules/hold-music)
- [Sticky Agent](https://edesy.in/docs/call-forwarding/rules/sticky-agent)
- [Turn Off a Rule](https://edesy.in/docs/call-forwarding/rules/disable-a-rule)