> ## 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 QuickBooks Account API

> Update or deactivate an account in the linked QuickBooks Online company from Breezing, addressed by its account code in the chart.



## OpenAPI

````yaml PATCH /qbo/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:
  /qbo/accounts/{code}:
    patch:
      tags:
        - QuickBooks
      summary: Update a QuickBooks account
      description: >-
        Partial update of one account in the linked QuickBooks Online company,
        addressed by the account code from the chart, which is the QuickBooks
        account Id. Updatable: name, account type and subtype, account number,
        description, and active (false makes the account inactive at QuickBooks
        and removes it from the stored chart). The code itself never changes.
        QuickBooks applies its own rules (unique names, a subtype that fits the
        type) and the message of a rejected change is returned as a 400. The
        stored chart entry is updated in the same call, so no refresh is needed.
        Returns 404 when QuickBooks has no account with this Id and 400 when
        QuickBooks is not linked. Requires write access.
      parameters:
        - schema:
            type: string
            minLength: 1
            maxLength: 64
            description: >-
              The account code as it appears in the chart (URL-encoded when it
              carries reserved characters). For QuickBooks this is the account
              Id.
            example: '1200'
          required: true
          description: >-
            The account code as it appears in the chart (URL-encoded when it
            carries reserved characters). For QuickBooks this is the account Id.
          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/UpdateQboAccountBody'
      responses:
        '200':
          description: QuickBooks account updated
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    enum:
                      - true
                  data:
                    $ref: '#/components/schemas/AccountingAccount'
                required:
                  - success
                  - data
        '400':
          description: >-
            QuickBooks not linked, no fields to update, or QuickBooks rejected
            the change
          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: QuickBooks has no account with this Id
          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:
    UpdateQboAccountBody:
      type: object
      properties:
        name:
          type: string
          minLength: 1
          maxLength: 100
          description: New display name (unique in QuickBooks).
        accountType:
          type: string
          enum:
            - Bank
            - Other Current Asset
            - Fixed Asset
            - Other Asset
            - Accounts Receivable
            - Equity
            - Expense
            - Other Expense
            - Cost of Goods Sold
            - Accounts Payable
            - Credit Card
            - Long Term Liability
            - Other Current Liability
            - Income
            - Other Income
          description: >-
            New QuickBooks AccountType. Send a matching accountSubType with it
            when the current subtype does not fit the new type.
        accountSubType:
          type: string
          description: >-
            New QuickBooks AccountSubType (e.g. "Checking", "Savings",
            "CashOnHand"). Must be valid for the account type.
        acctNum:
          type: string
          description: >-
            New account number. The chart shows it as "(number) - name"; an
            empty string clears it.
        description:
          type: string
          maxLength: 100
          description: New description.
        active:
          type: boolean
          description: >-
            false makes the account inactive at QuickBooks and removes it from
            the stored chart; true reactivates it.
    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.