Remove a project budget

​

Stops tracking a project's budget. The budget and its cycles are removed, the project reads back with budget: null, and the response hands back the budget's final state, current_cycle included, so you can log what went. Start a new one with POST /public-api/v1/projects/{id}/budget.

Removing a budget needs permission to change the project and see its budget, but not a plan that includes budgets, so a company that moved to a plan without them can still remove the ones it has. A project without a start_date returns 422; set one with PATCH /public-api/v1/projects/{id} first.

A project the token cannot see returns 404, and so does one with no budget. A project it can see returns 403 when the token may not change the project or see its budget.

Path Parameters

  • project_id
    Type: integer
    required

    The project's id.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for delete/public-api/v1/projects/{project_id}/budget
curl https://app.hellobonsai.com/public-api/v1/projects/1/budget \
  --request DELETE \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": {
    "id": 41,
    "amount": "5000.0",
    "over_budget_notification_threshold": "80.0",
    "calculation_mode": "fee",
    "calculation_base": "billable_time_and_expenses",
    "expenses_calculation_base": "all",
    "reset_frequency": "monthly",
    "over_budget_notification": "enabled",
    "current_cycle": {
      "opening_date": "2026-03-01",
      "closing_date": "2026-03-31",
      "consumed_amount": "1250.0",
      "consumed_percentage": 25
    }
  },
  "meta": {
    "request_id": "b1f0d2c4-7a9e-4c3b-8d5f-1e2a3b4c5d6e"
  }
}

The budget was removed. Its final state is in data.