> ## Documentation Index
> Fetch the complete documentation index at: https://learn.breezing.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Chart Account API

> Update the name, type, or statement classification of one GL account in a Breezing chart of accounts, addressed by its account code.



## OpenAPI

````yaml PATCH /accounts/{code}
openapi: 3.1.0
info:
  title: Breezing Public API
  version: 1.0.0
  description: >-
    Crypto accounting API for programmatic access and AI agents. Authenticate
    with an API key using the Authorization header: `Bearer brz_...`
servers:
  - url: https://api.breezing.io/v1
security:
  - BearerAuth: []
paths:
  /accounts/{code}:
    patch:
      tags:
        - Chart of Accounts
      summary: Update a chart account
      description: >-
        Partial update of one account by its code: name, type and the
        classification override (null puts the account back on automatic
        classification). The code itself never changes: transactions, assets,
        rules and mappings reference accounts by code, so restructuring codes
        stays a dashboard CSV upload. Returns 404 when the code is not in the
        chart. Each call lands as one Chart Version (source "Public API").
        Requires write access.
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 64
            description: >-
              The account code (URL-encoded when it carries reserved
              characters).
            example: '6200'
          required: true
          description: The account code (URL-encoded when it carries reserved characters).
          name: code
          in: path
        - schema:
            type: string
            description: >-
              Organization ID. Use GET /v1/companies to discover available
              org/company pairs.
            example: '1'
          required: true
          description: >-
            Organization ID. Use GET /v1/companies to discover available
            org/company pairs.
          name: orgId
          in: query
        - schema:
            type: string
            description: >-
              Company ID. Use GET /v1/companies to discover available companies
              and their access levels.
            example: '1'
          required: true
          description: >-
            Company ID. Use GET /v1/companies to discover available companies
            and their access levels.
          name: companyId
          in: query
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateChartAccountBody'
      responses:
        '200':
          description: Account updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    $ref: '#/components/schemas/AccountingAccount'
                required:
                  - success
                  - data
        '400':
          description: 'Bad request: no fields to update or an unknown classification'
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '401':
          description: Invalid or missing API key
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '403':
          description: >-
            API key has no access to this company, has read-only access where
            write was required, or the company subscription is inactive
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '404':
          description: Account code not found in the chart
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - false
                  error:
                    type: object
                    properties:
                      code:
                        type: string
                      message:
                        type: string
                    required:
                      - code
                      - message
                required:
                  - success
                  - error
      security:
        - BearerAuth: []
components:
  schemas:
    UpdateChartAccountBody:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 200
        type:
          type: string
          maxLength: 64
          description: >-
            Free-text account type; changing it changes the automatic
            classification unless an override is stored.
        classification:
          type: string
          nullable: true
          maxLength: 40
          description: >-
            Statement classification override: one of the twelve keys (bank,
            currentAsset, fixedAsset, nonCurrentAsset, currentLiability,
            nonCurrentLiability, equity, revenue, otherIncome, costOfSales,
            expense, otherExpense) or its label ("Current Asset"). Omit for
            automatic derivation from `type`. On PATCH, null clears a stored
            override.
    AccountingAccount:
      type: object
      properties:
        code:
          type: string
          nullable: true
          description: >-
            Account code/identifier. Use this exact value when setting
            `account`, `assetAccount`, or `feeAssetAccount` on a transaction or
            asset.
        name:
          type: string
          nullable: true
          description: Display name of the account.
        type:
          type: string
          description: >-
            Account type as reported by the accounting platform (e.g. "Bank",
            "Other Current Asset", "EXPENSE").
        classification:
          type: string
          nullable: true
          enum:
            - bank
            - currentAsset
            - fixedAsset
            - nonCurrentAsset
            - currentLiability
            - nonCurrentLiability
            - equity
            - revenue
            - otherIncome
            - costOfSales
            - expense
            - otherExpense
            - null
          description: >-
            Breezing statement classification derived from the account type
            (bank, currentAsset, fixedAsset, nonCurrentAsset, currentLiability,
            nonCurrentLiability, equity, revenue, otherIncome, costOfSales,
            expense, otherExpense), or null when the type could not be
            classified. Decides where the account lands on the Profit and Loss
            and Balance Sheet; editable per account on the Chart of Accounts
            page.
      required:
        - code
        - name
        - type
        - classification

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.