---
title: "Update an account. Disabling preserves history and excludes the account from default reads. Accessing or re-enabling an already-disabled account requires include_disabled=true in the query."
method: PATCH
path: "/api/v2/accounts/{id}"
---

# Update an account. Disabling preserves history and excludes the account from default reads. Accessing or re-enabling an already-disabled account requires include_disabled=true in the query.

`PATCH /api/v2/accounts/{id}`

## Request

- Base URL: `https://fintable.io`
- URL: `https://fintable.io/api/v2/accounts/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Query parameters

- `workspace_id` string
- `include_disabled` boolean

## Request body

- object
  - `display_name` string, nullable: Requires the write scope.
  - `sync_start_date` string, date, nullable: A read scope may send this field alone, and only to move the date EARLIER; clearing it (null) and moving it later both require write.
  - `enabled` boolean: Requires the write scope.
  - `reverse_balance_sign` boolean: Reverse the primary balance sign for this account. Available balance is unchanged. Defaults to false; requires write scope.
  - `reverse_transaction_sign` boolean: Reverse existing and future transaction amounts, pending items and report totals for this account. Raw bank data is unchanged. Existing spreadsheet rows need an overwrite re-sync. Defaults to false; requires write scope.
  - `balance_source` string, nullable: A source returned by balance_sources_available on GET /accounts/{id}; null restores Fintable's default. Changes only this account's primary balance and leaves balance_available unchanged. Requires the write scope.
  - `description_parts` string[], nullable: Which pieces the transaction description is built from, in order. Each entry is either a curated part (reference, statement, memo, counterparty) or raw:<field> naming any field the bank itself sends, e.g. raw:creditorAccount.iban. See description_parts_available and description_fields_available on the account. null restores the provider default. Changing this recomposes the transactions already stored (spreadsheets need a Force Re-Sync). Requires the write scope.

## Response `200`

A {"data": {...}} envelope.

- DataObject
  - `data` object
  - `workspace_id` string: Public ID of the Workspace this successful response was resolved against (workspace-bound endpoints only).

## Other responses

- `403`: The standard error envelope.
- `422`: The standard error envelope.

---

[API](https://skmtc.dev/fintable/apis/fintable-api.md) · [All operations](https://skmtc.dev/fintable/apis/fintable-api/llms.txt) · [OpenAPI document](https://skmtc.dev/fintable/apis/fintable-api/revisions/b5ed1cf8f417?raw)