---
title: "Update budget"
method: PUT
path: "/api/v1/budgets/{id}"
tags: ["Finance Management.Budgets", "ENTERPRISE"]
---

# Update budget

`PUT /api/v1/budgets/{id}`

Updates the specified budget.

## Path parameters

- `id` string, required

## Request body

- UpdateBudgetRequest — Update the budget with the requested fields.
  - `amount` Amount, required
    - `currencyCode` string, required — The ISO 4217 currency code of the amount
    - `scale` integer, required — The scale of the amount. The `unscaledValue` is used with `scale` to accurately represent floating point values. The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
    - `unscaledValue` integer, required — The unscaled value of the amount. The `unscaledValue` is used with `scale` to accurately represent floating point values. The formula is `unscaledValue * (10^-scale)`. For example, if scale is 1 and unscaledValue is 1230, the end result would be 123.0.
  - `filter` Filter — The filter defining the budget and which transactions that is included in it. The configured fields of the filter are applied as logical and operator (intersection).
    - `accounts` BudgetFilterAccount[] — List of included accounts. Applied as logical or (union).
      - `id` string — The account ID.
    - `categories` BudgetFilterCategory[] — List of included categories. Applied as logical or (union).
      - `code` string — The category code.
    - `freeTextQuery` string — Query for a partial transaction description match.
    - `tags` BudgetFilterTag[] — List of included tags. Applied as logical or (union).
      - `key` string — The tag key.
  - `name` string — The name of the Budget.
  - `oneOffPeriodicity` BudgetOneOffPeriodicity — Periodicity configuration for a ONE_OFF budget.
    - `end` integer, required — Budget start expressed as UTC epoch timestamp in milliseconds.
    - `start` integer, required — Budget end expressed as UTC epoch timestamp in milliseconds.
  - `recurringPeriodicity` BudgetRecurringPeriodicity
    - `periodUnit` 'WEEK' | 'MONTH' | 'YEAR' — Recurring periodicity unit.

## Response `200`

A Successful response

- UpdateBudgetResponse
  - `budgetSpecification` Finance20ManagementBudgets — unresolved $ref

## Other responses

- `400` — If any of the request parameters is incorrect or missing
- `401` — If the user is not authorized.
- `404` — Budget not found
- `500` — For any unspecified error

---

[API](https://skmtc.net/tink/apis/tink-api.md) · [All operations](https://skmtc.net/tink/apis/tink-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tink/tink-api/revisions/23d8982b533d/schema)