CAcardda
Budget

Edit the amount of a tracking budget

Changes the planned amount of a tracking ("Solo control") budget. It moves no company balance: the budget only measures spend against the new amount. A funded budget is not edited through this endpoint. The change and its reason are kept in the budget's funds history (GET /v1/budgets/{id}/fund_movements).

Requires admin or the budgets_manage permission. A caller without it, or a request on a funded budget, gets 401. Returns the updated budget.

patch/v1/budgets/{id}/amount

Request

  • Base URL
    https://api.cardda.com
  • URL
    https://api.cardda.com/v1/budgets/{id}/amount
  • Auth
    HTTP bearer

Path parameters

idstring uuid required

The UUID of the balance group (budget).

Parameters

#/paths/~1v1~1bills/get/parameters/0 (unresolved $ref)

Request body

amount_centsinteger required

The new planned amount, in the smallest currency unit. Must be greater than 0 and not lower than what the budget has already consumed: its net spend, -consumed_balance_cents of the Budget response. Transfers still in flight, which used_cents also counts, do not raise that floor.

reasonstring

Optional. When present, it is stored as the comment of the change's audit record and kept in the budget's funds history (GET /v1/budgets/{id}/fund_movements).

Example request

{
  "amount_cents": 8000000,
  "reason": "Ajuste de presupuesto para el cuarto trimestre"
}

Response

The updated budget.

OR

Example response

{
  "name": "Marketing",
  "description": "Presupuesto del equipo de marketing",
  "currency": "CLP",
  "mode": "funded",
  "allocated_amount_cents": 5000000,
  "committable_cents": 3200000,
  "available_cents": 3500000,
  "consumed_balance_cents": -1500000,
  "used_cents": 1500000,
  "remaining_cents": 3500000,
  "vendor_cards": [
    {
      "last4": "4242",
      "limit_currency": "CLP"
    }
  ],
  "recurrence_unit": "month",
  "recurrence_every": 1,
  "base_amount_cents": 5000000,
  "period_ends_on": "2026-11-20",
  "ends_on": "2026-12-01"
}

Changes

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