# Tool.dispatch
URL: https://lsd.tools/docs/api-tool-dispatch
Updated: 2026-07-17

## Parameters

| name | type | default | description |
|---|---|---|---|
| `route` | `str` | — | the route of a registered [`action`](/docs/api-tool-action), e.g. `"app/refresh"` |
| `ctx` | `Context` | `None` | the Context to pass; built from the mounted host when omitted |
| `**values` | `Any` | — | the field values forwarded to the action function |

## Example

```python
tool.dispatch("app/refresh")
tool.dispatch("entity/drillholes/export", path="out.csv")
```

## Notes

When `ctx` is `None`, a `Context` is built from the host stored at [`mount`](/docs/api-tool-mount).
Raises `KeyError` if no action is registered for `route`.

## See also

**API:** [action](/docs/api-tool-action) · [mount](/docs/api-tool-mount) · [Context](/docs/api-context)

**Guides:** [Commands & actions](/docs/tools-commands-actions)