> ## Documentation Index > Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt > Use this file to discover all available pages before exploring further. # Update an account > Updates the editable fields of an account of your organization. Currently, only the `description` is editable. **`v2`** ยท Base URL `https://api.fintoc.com/v2` Only the `description` attribute can be updated for the `Account` model. ## OpenAPI ````yaml reference/pacioli-api.json PATCH /accounts/{id} openapi: 3.1.0 info: title: Fintoc API version: v2026-02-01 servers: - url: https://api.fintoc.com/v2 security: [] paths: /accounts/{id}: patch: tags: - Accounts summary: Update an account description: >- Updates the editable fields of an account of your organization. Currently, only the `description` is editable. operationId: accounts-update parameters: - name: id in: path required: true schema: type: string description: Unique identifier of the account to update. requestBody: content: application/json: schema: type: object properties: description: type: string description: >- New free-text description for the account. Up to 40 characters. example: Updated description required: true responses: '200': description: The updated account. content: application/json: examples: account_updated: value: id: acc_2daFu0zqqDtZGJaSi2TGI2Mm1nN object: account available_balance: 1050000 currency: MXN description: Updated description entity: id: ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9 holder_id: '000000000' holder_name: Test Customer 1 is_root: true is_root: true mode: test root_account_number: '646180111800000000' root_account_number_id: acno_2fJkRm7tBvQxNzYpLc5WsHaDfT3 status: active schema: $ref: '#/components/schemas/account' '400': description: The request parameters are invalid. content: application/json: examples: invalid_description_size: value: error: code: invalid_description_size message: Description length must be less than 40 characters schema: $ref: '#/components/schemas/error_object' '401': description: Invalid or missing API key. content: application/json: examples: invalid_api_key: value: error: type: authentication_error code: invalid_api_key message: 'Invalid API Key: invalid-*oken' schema: $ref: '#/components/schemas/error_object' '403': description: Accounts can only be updated for Mexico organizations. content: application/json: examples: account_update_not_available: value: error: code: invalid_account message: >- Unable to update account acc_2daFu0zqqDtZGJaSi2TGI2Mm1nN. Action not available in your region schema: $ref: '#/components/schemas/error_object' '404': description: No account with the given ID exists in your organization. content: application/json: examples: not_found: value: error: code: missing_resource message: 'Account not found: acc_2daFu0zqqDtZGJaSi2TGI2Mm1nN' schema: $ref: '#/components/schemas/error_object' security: - api_key: [] components: schemas: account: type: object properties: id: type: string description: Unique identifier of the account. example: acc_2daFu0zqqDtZGJaSi2TGI2Mm1nN object: const: account description: Type of the object. Always `account`. available_balance: type: integer description: >- 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. example: 1050000 currency: type: string enum: - CLP - MXN description: ISO 4217 currency code of the account. One of `CLP`, `MXN`. example: MXN description: type: - string - 'null' description: Free-text description of the account, or `null` when none is set. example: Main collection account entity: type: object description: Owner entity of the account. properties: id: type: string description: Identifier of the entity. example: ent_2eGhTp1rLqWnXkZbYc4JsKmAvD9 holder_id: type: string description: >- Tax identifier of the owner. A Chilean tax ID (RUT) or a Mexican tax ID (RFC). example: '000000000' holder_name: type: string description: Legal name of the owner. example: Test Customer 1 is_root: type: boolean description: Whether this entity is the root entity. example: true required: - id - holder_id - holder_name - is_root is_root: type: boolean description: Whether this account is the organization's root account. example: true mode: type: string enum: - live - test description: Whether the account holds `live` or `test` data. example: test root_account_number: type: string description: >- Default account number of the account. In Mexico, the 18-digit standardized bank account number (CLABE); in Chile, the bank account number. example: '646180111800000000' root_account_number_id: type: string description: Identifier of the default account number. example: acno_2fJkRm7tBvQxNzYpLc5WsHaDfT3 status: type: string enum: - active - blocked - closed description: Status of the account. One of `active`, `blocked`, `closed`. example: active required: - id - object - available_balance - currency - description - entity - is_root - mode - root_account_number - root_account_number_id - status error_object: type: object properties: error: type: object description: Details of the error that caused the request to fail. properties: code: type: string description: >- Machine-readable code identifying the specific error, for example `invalid_request`. example: invalid_request doc_url: type: string description: >- URL of a documentation page with more details about the error. Not returned by every error. example: https://docs.fintoc.com/reference/errors message: type: string description: Human-readable message describing the error. example: 'Missing required param: account_id' param: type: - string - 'null' description: >- Name of the request parameter that caused the error. Not returned by every error. example: account_id type: type: string description: >- Category of the error, for example `invalid_request_error` or `authentication_error`. Not returned by every error. example: invalid_request_error required: - code - message required: - error securitySchemes: api_key: type: apiKey name: Authorization in: header ````