Skip to content
campaiDeveloper
campai.com

Finance · Accounting · Budgets

DELETE/{organizationId}/{mandateId}/finance/accounting/budgets/{budgetId}

Delete budget

Deletes a budget identified by organizationId, mandateId, and budgetId. Approved budgets must be reopened before deletion. A successful request returns no content.

Permissions

Send an API key of the organization in the path, using the X-API-Key header.

Who may call it

  • The caller must have organization access.
  • The caller needs mandate.read.
  • The caller needs budget.remove.

Request

Path parameters

  • organizationIdidrequired
  • mandateIdidrequired
  • budgetIdidrequired
Request
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
  --request DELETE 'https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/YOUR_MANDATE_ID/finance/accounting/budgets/YOUR_BUDGET_ID' \
  --header 'X-API-Key: YOUR_API_KEY'

Response

200 Successful response

No response body is specified.

What else happens

  • If the budget is found and is not approved, it is deleted.

Errors

Other errors

StatusErrorWhen
400The budget is approved. Reopen it to change it.If the budget is approved, the endpoint returns HTTP 400 with key routes.finance.accounting.budgets.approved.
404Budget was not foundIf the budget is not found, the endpoint returns HTTP 404 with key routes.finance.accounting.budgets.notFound.

Errors nearly every request can meet are listed under Errors.