---
title: "Update an account"
method: PATCH
path: "/accounts/{id}"
tags: ["Accounts"]
---

# Update an account

`PATCH /accounts/{id}`

Updates the editable fields of an account of your organization. Currently, only the `description` is editable.

## Path parameters

- `id` string, required

## Request body

- object
  - `description` string — New free-text description for the account. Up to 40 characters.

## Response `200`

The updated account.

- Account
  - `id` string, required — Unique identifier of the account.
  - `object` 'account', required — Type of the object. Always `account`.
  - `available_balance` integer, required — Available balance of the account, in the smallest currency unit. For MXN the smallest unit is the centavo; for CLP it is the peso, which has no minor unit.
  - `currency` 'CLP' | 'MXN', required — ISO 4217 currency code of the account. One of `CLP`, `MXN`.
  - `description` string, nullable, required — Free-text description of the account, or `null` when none is set.
  - `entity` object, required — Owner entity of the account.
    - `id` string, required — Identifier of the entity.
    - `holder_id` string, required — Tax identifier of the owner. A Chilean tax ID (RUT) or a Mexican tax ID (RFC).
    - `holder_name` string, required — Legal name of the owner.
    - `is_root` boolean, required — Whether this entity is the root entity.
  - `is_root` boolean, required — Whether this account is the organization's root account.
  - `mode` 'live' | 'test', required — Whether the account holds `live` or `test` data.
  - `root_account_number` string, required — Default account number of the account. In Mexico, the 18-digit standardized bank account number (CLABE); in Chile, the bank account number.
  - `root_account_number_id` string, required — Identifier of the default account number.
  - `status` 'active' | 'blocked' | 'closed', required — Status of the account. One of `active`, `blocked`, `closed`.

## Other responses

- `400` — The request parameters are invalid.
- `401` — Invalid or missing API key.
- `403` — Accounts can only be updated for Mexico organizations.
- `404` — No account with the given ID exists in your organization.

---

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