latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-201,4701,08213.3 MB

905703de9c0f

billing

Delete a budget

Deletes a budget by ID. Enterprise owners and billing managers can delete any budget in the enterprise, organization administrators can delete budgets scoped to organizations they administer, and repository administrators can delete budgets scoped to repositories they administer in those organizations. A custom role holder with fine-grained write access to enterprise billing does not by itself get permission to delete a budget for a target they do not administer. An installation access token for a GitHub App installed on the enterprise with write access to enterprise billing can delete any budget in the enterprise.

delete/enterprises/{enterprise}/settings/billing/budgets/{budget_id}

Path parameters

enterprisestring required

The slug version of the enterprise name.

budget_idstring required

The ID corresponding to the budget.

Response

Response when deleting a budget

messagestring required

A message indicating the result of the deletion operation

idstring required

The ID of the deleted budget