---
title: "Update Account"
method: PATCH
path: "/{account_id}/"
tags: ["Accounts"]
---

# Update Account

`PATCH /{account_id}/`

Partially update an existing account. 

Only the fields provided in the request body will be modified; all other fields will remain unchanged.

## Path parameters

- `account_id` string, required

## Headers

- `x-company-id` integer — ID of a child company for authentication. If not provided, the parent company will be authenticated.

## Request body

- RequestUpdateAccount
  - `label` string — Label of the account
  - `products` AccountProductsEnum[] — List of products associated with the account. Requires the product to be already enabled for the company. Valid values: PAYOUTS, PAYINS, INTERNAL_TRANSFER
  - `webhook_url` string — URL for movement notifications (will follow the same schema as the Get Movement endpoint)
  - `enabled` boolean — Indicates if the account is enabled or not. Disabled accounts will not be able to perform any operations until they are enabled again.

## Response `200`

Successful Response

- AccountResponse
  - `status` 'success'
  - `data` PublicAccountSchema, required
    - `id` integer, required — Account ID
    - `created_at` string, date-time — Creation date of the account
    - `updated_at` string, date-time — Last update date of the account
    - `status` 'PROVISIONING' | 'ACTIVE' | 'SUSPENDED' | 'CLOSED' | 'REJECTED'
    - `label` string — Account label
    - `idempotency_key` string — Idempotency key for the account creation, it can also be used as an external identifier
    - `bank` string, required — Name of the bank where the account is held
    - `company_id` integer — Company ID associated with the account
    - `currency` 'BRL' | 'BRLA' | 'MXN' | 'ARS' | 'COP' | 'CLP' | 'BOB' | 'PYG' | 'SGD' | 'PEN' | 'EUR' | 'GBP' | 'USD' | 'USDT' | 'USDC' | 'UYU' | 'USDC_POL' | 'USDT_POL' | 'EURC_BASE' | 'USDC_BASE' | 'USDT_BASE' | 'USDC_ETH' | 'USDT_ETH' | 'EURC_ETH' | 'USDC_TEMPO' | 'USDT_TEMPO' | 'EURC_TEMPO' | 'BRLA_ETH' | 'BRLA_POL' | 'BRLA_BASE' | 'TGBP_ETH' | 'TGBP_POL' | 'TGBP_BASE', required
    - `country` 'BR' | 'AR' | 'CO' | 'CL' | 'BO' | 'PY' | 'SG' | 'PE' | 'MX' | 'UY' | 'US' | 'EU' | 'XX' | 'GB', required
    - `account_number` string — Account number
    - `enabled` boolean — Indicates if the account is enabled or not. Disabled accounts will not be able to perform any operations until they are enabled again.
    - `account_type` string — Type of the account
    - `document_number` string — Document number of the account holder
    - `document_type` string — Document type of the account holder
    - `funding_instructions` union — Funding instructions for the account, if applicable
      - FiatFundingInstructions
        - `type` 'fiat'
        - `account_number` string — Account number to fund
        - `bank_name` string — Bank name associated with the account number
        - `bank_code` string — Bank identifier (routing number in USA, sort code in UK, ISPB in BR, etc.)
        - `br_code` string — BR code for Brazil (BRL) funding instructions
        - `breb_key` string — BREB key for Colombia (COP) funding instructions
        - `ted_brl` TedBRLFundingRail
          - `bank_code` string, required
          - `branch_number` string, required
          - `account_number` string, required
          - `account_type` string, required
          - `beneficiary_name` string
          - `beneficiary_document` string
        - `pix_key_brl` PixKeyBrlFundingRail
          - `pix_key` string, required
        - `br_code_brl` BrCodeBrlFundingRail
          - `br_code` string, required
      - CryptoFundingInstructions
        - `type` 'crypto'
        - `crypto_address` string, required — Crypto address to funds
        - `crypto_network` string, required — Crypto network to fund
    - `balance_details` BalanceSchema
      - `total` number — The overall balance, including both available and held funds.
      - `available` number — The portion of the balance that is currently available for transactions, excluding amounts held for pending operations.
      - `last_update` string, date-time — The timestamp of the last balance update, reflecting the most recent change.
    - `is_virtual_account` boolean — Indicates if the account is a virtual account
    - `webhook_url` string — Webhook URL for movement notifications
    - `status_callback_url` string — Callback URL for account-level events
    - `products` AccountProductsEnum[] — List of products associated with the account
    - `owner_id` string — UUID of the Account Owner linked to this account

## Other responses

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

---

[API](https://skmtc.net/infiniaweb/apis/payins.md) · [All operations](https://skmtc.net/infiniaweb/apis/payins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/infiniaweb/payins/revisions/3f453785c478/schema)