# willo_db_delete

> Delete rows from one table where every where column equals its value.

Generated from Willo's code at each release.

Source: https://www.willo.ai/docs/reference/mcp-tools/willo_db_delete

**Delete rows.** ALWAYS needs a person's approval; no undo. A delete matching more than one row is refused unless `expected_rows` equals the number it matches. Runs on the draft backend while the business is drafting (Publish replays it live), otherwise on the LIVE backend; the result's `[Backend: …]` line says which.

## Access

- **Token**: read + act, and editor access or higher on the business.
- **Approval**: Always. Every call raises a card a person approves on the dashboard.
- **Secret scan**: refused if the new content holds a value shaped like an API key or token.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `table` | string | yes | Table name. |
| `where` | object | yes | {column: value} — every pair must match; never empty. |
| `expected_rows` | integer ≥ 1 | no | Required when more than one row matches: exactly how many. |

## Related

- [All MCP tools](https://www.willo.ai/docs/reference/mcp-tools)
- [Error codes](https://www.willo.ai/docs/reference/errors)
- [Draft and live](https://www.willo.ai/docs/ai-agents/draft-and-live)