HEhellobonsai
Projects

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.

delete/public-api/v1/projects/{project_id}/budget

Request

  • Base URL
    https://app.hellobonsai.com
  • URL
    https://app.hellobonsai.com/public-api/v1/projects/{project_id}/budget
  • Auth
    • OAuth 2
      Authorization code: https://app.hellobonsai.com/oauth/authorize
      Token URL: https://app.hellobonsai.com/oauth/token
    • or HTTP bearer

Response

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

Example response

{
  "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"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.