delete_table
Delete one of your tables, with every row in it.
Destructive. confirm_name must equal the table’s exact name — read it back
to the user before calling. In the in-product agent this tool opens the
approval modal.
Parameters#
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
table_id | string | yes | The table id | |
confirm_name | string | yes | The table’s exact name, as confirmation |
Returns#
json
{ "deleted": true, "table_id": "dtbl_abc123", "name": "Q3 leads", "rows_deleted": 42 }Errors#
error_type | When |
|---|---|
auth_error | Missing / invalid API key |
confirmation_required | confirm_name does not match the table name |
not_found | Unknown or platform-managed table |