v1

latestOpenAPI 3.0.12026-07-24310590875.6 KB
budgets

Delete a budget

Delete an existing budget. A deleted budget cannot be restored. The deleted budget is not available in the list of budgets.

Note:

  • While you cannot restore a deleted budget with the API, you can unretire budgets in the BILL web app and mobile app. An unretired budget is active and is available for use.
  • A one-time budget can be unretired at any time. A recurringInterval budget can be unretired within one interval. For example, if a MONTHLY budget is retired in January, you can unretire it in February. You cannot unretire this budget in March or any later month.
delete/v3/spend/budgets/{budgetId}

Path parameters

budgetIdstring required

BILL-generated ID or UUID of the budget

Example:{{se_budget_uuid}}

Headers

apiTokenstring nullable

Access token for Spend & Expense API authentication

Example:{{api_token}}

Response

Delete a budget response