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

# Update inbound router

> Turn an agent's inbound router on or off and change its default task, AI thresholds, and clarifying questions. Requires confirm: true.

Send only the settings you want to change, plus `"confirm": true`. Settings you leave out keep their value. Any other key returns 400 `invalid_router_settings_field`, with the unknown keys in `fields`.

## Turn the router on

```json theme={null}
{ "is_active": true, "default_workflow_id": "22222222-2222-4222-8222-222222222222", "confirm": true }
```

* Without a default task, Nexor uses the agent's oldest task, taken from `candidate_workflow_ids` when that list is set.
* The default task must be one of the agent's tasks. A paused task is allowed.
* When `candidate_workflow_ids` is set, the default task must be in that list.

## Decide when the agent asks first

| Setting | Default | Effect |
| - | - | - |
| `confidence_threshold` | `0.75` | From this AI confidence up, the conversation goes straight to the task. |
| `clarify_threshold` | `0.55` | Between this value and `confidence_threshold`, the agent asks the lead a clarifying question on WhatsApp and web chat. Below it, the default task answers. It cannot be higher than `confidence_threshold`. |
| `ambiguity_margin` | `0.25` | When two tasks score within this margin, the agent asks first. `0` turns this off. |
| `max_profiling_turns` | `3` | Most questions the agent asks, from 1 to 5. After that it uses the best match or the default task. |

Check the result with [Test a message](/docs/en/api/inbound-router/test-inbound-router) before real leads write.

## Turn the router off

```json theme={null}
{ "is_active": false, "confirm": true }
```

Turning the router off works even when saved task IDs are out of date.


## API Specification

The full API specification for this endpoint is available in the [documentation index](https://docs.getnexor.ai/llms.txt).
