---
title: "Update account balance history config v2"
method: PATCH
path: "/bank-statements/v2/account-balances/history/config/{balanceHistoryConfigId}"
tags: ["Bank statements"]
---

# Update account balance history config v2

`PATCH /bank-statements/v2/account-balances/history/config/{balanceHistoryConfigId}`

Update the account balance history configuration.

When you call this endpoint after `cycle_config_validity.start`, the new configuration is valid only after the two-cycle closing date.
Example:
  - division timezone: UTC
  - Update account balance history configuration called at: `2023-05-01T18:00:00Z`
  - current cycle closing time: 22:00:00
  - current cycle closing date: 2023-04-30 (from `2023-04-30T22:00:00Z` to `2023-05-01T22:00:00Z`)
  - cycle config validity start datetime of the new config: `2023-05-02T22:00:00Z`
  - current config stays valid until `2023-05-02T22:00:00Z`

If this endpoint is called when the current datetime is less than or equal to `cycle_config_validity.start` of the most recent configuration, the new configuration overrides the the most recent configuration.
Example:
  - division timezone: UTC
  - Update account balance history configuration called at: `2023-05-01T19:00:00Z`
  - Cycle config validity start datetime of the most recent configuration: `2023-05-02T22:00:00Z`
  - New config overrides the most recent configuration settings, keeping the same cycle config validity start date: `2023-05-01T22:00:00Z`

This endpoint generates an [Account balance history configuration changed](https://developers.pismo.io/events/docs/account-balances-balance-history-config-change-1) event.

## Path parameters

- `balanceHistoryConfigId` string, uuid, required

## Request body

- UpdateAccountBalanceHistoryConfigurationRequestV2 — Update account balance history configuration request object
  - `cycle_closing_time` string, time — Cycle closing time indicates what time of day the cycle closes for a division, organization, or program. This time uses the timezone configured for the corresponding division, organization, or program.
  - `cycle_event_delay` integer — The cycle event delay specifies how many minutes after `cycle_closing_time` the account balance history event is issued for each account in the division.

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/pismo/apis/platform-authentication.md) · [All operations](https://skmtc.net/pismo/apis/platform-authentication/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pismo/platform-authentication/revisions/935b62e16de4/schema)