Bookkeeping

Delete a budget

books_delete_budget · Deletes data · Markdown

Deletes a budget; the books don't change.

Free

This tool costs nothing to call.

An example

Delete last year's draft budget.

Your agent callsbooks_delete_budgetFree

The example business is Hansen & Voss, a restaurant-equipment wholesaler in Hamburg with 60 staff. The reply is the one the tool really gives.

With these arguments
{
  "name": "2026"
}
What comes back
{
  "deleted": "2026"
}

Use it when

A plan is replaced or no longer needed.

What it does

Delete a budget. The books don't change.

What comes back

deleted: the budget's name. Every reply also carries cost_usd and balance_usd.

Inputs

NameTypeWhat it is
nameRequiredstringThe budget's name, e.g. "2026". 1 to 80 characters.

The call

Over MCP, call books_delete_budget on https://api.conecto.chat/mcp/books. Over REST:

Terminal
curl -X POST https://api.conecto.chat/v1/tools/books_delete_budget \
  -H "Authorization: Bearer $CONECTO_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"2026"}'

When it refuses

A refused call costs nothing and says what to do next.

CodeWhenWhat to do
no_books409The business keeps no books yet.Set them up with books_setup (base currency, start date).
not_found404No budget has that name.List them with books_list_budgets.

Give this to your agent.

Set up Conecto from https://conecto.chat/SKILL.md