Skip to main content
PATCH
Update company accounting configuration

Query Parameters

orgId
string
required

Organization ID. Use GET /v1/companies to discover available org/company pairs.

Example:

"1"

companyId
string
required

Company ID. Use GET /v1/companies to discover available companies and their access levels.

Example:

"1"

Body

application/json
name
string

Company display name. Shown throughout Breezing and on exported reports/journals.

Required string length: 1 - 256
Example:

"Acme Corp"

accountingMethod
enum<string>

Cost-basis method used to compute realized net gain/loss when crypto is disposed: • "fifo" = First In, First Out: the earliest-acquired units are treated as sold first. • "average" = Weighted Average Cost (WAC): cost basis is the running average cost of all units held. • "lifo" = Last In, First Out: the most recently-acquired units are treated as sold first. • "hifo" = Highest In, First Out: the highest-cost units are treated as sold first. Changing the method does NOT retroactively rewrite past figures; run an NGL recompute (POST /ngl/calculate) afterward to apply it.

Available options:
average,
fifo,
lifo,
hifo
Example:

"fifo"

balanceSheetSetup
enum<string>

Determines how crypto holdings are mapped to balance-sheet (asset) GL accounts: • "token" = Token Based: one GL account per token, aggregated across all wallets (e.g. all ETH rolls into "Crypto Assets - ETH"). Token→account mappings are managed via PATCH /assets/{id}. • "wallet" = Wallet Based: one GL account per custody location (wallet). Asset accounts are assigned per-transaction, typically automated with Rules. • "wallet-token" = Wallet-Token Based: one GL account per wallet+token pair (e.g. "Treasury Wallet - ETH"). Assigned per-transaction, typically with multi-condition Rules. "wallet" and "wallet-token" both require Rules to automate asset-account assignment.

Available options:
token,
wallet,
wallet-token
Example:

"wallet-token"

accountingIsPerWallet
boolean

Per-Wallet cost basis. When true, realized net gain/loss is computed separately per wallet (each wallet keeps its own cost-basis pool). When false, a token's holdings are pooled across all wallets for cost-basis purposes. Affects NGL only; recompute NGL (POST /ngl/calculate) after changing.

isControlAccount
boolean

Use Control Accounts. When true, internal transfers and exchange trades post to the assigned control (clearing) accounts instead of the asset accounts. When false, they post directly to the asset accounts.

isCompact
boolean

TomDeFi Mode. When true, advanced journal entries are generated in a compact, consolidated format (fewer lines). When false, journals use the standard expanded format.

xeroSyncJournalsAsPosted
boolean

Xero journal posting status. When true, manual journals synced to Xero are pushed as POSTED (final). When false (default), they are created as DRAFT for review in Xero before posting. Affects Xero sync (POST /xero/sync) only; has no effect on QuickBooks or Bexio.

feeAccount
string | null

Default GL account for on-chain gas / transaction fees. Provide an account CODE from the chart of accounts (call GET /company to list codes); the server resolves the code to its name and type automatically and stores the full mapping. Pass null to clear the mapping.

Maximum string length: 127
Example:

"33"

netGainAccount
string | null

Default GL account where realized NET GAINS are booked. Provide an account CODE from the chart of accounts; the server resolves it to name and type. Pass null to clear the mapping.

Maximum string length: 127
Example:

"80"

netLossAccount
string | null

Default GL account where realized NET LOSSES are booked. Provide an account CODE from the chart of accounts; the server resolves it to name and type. Often the same account as netGainAccount. Pass null to clear the mapping.

Maximum string length: 127
Example:

"80"

fiatFeeAccount
string | null

GL account for fees paid in a FIAT currency (bank charges, Stripe or exchange fees charged in EUR, USD and so on). Provide an account CODE from the chart of accounts. Null clears it, and fiat fees then post to feeAccount.

Maximum string length: 127
Example:

"6050"

fxGainAccount
string | null

GL account for GAINS on conversions between two fiat currencies (a bank wallet EUR to USD conversion), booked as FX Gain/Loss journal lines. Provide an account CODE. Null clears it, and such gains then post to netGainAccount.

Maximum string length: 127
Example:

"8200"

fxLossAccount
string | null

GL account for LOSSES on conversions between two fiat currencies. Provide an account CODE. Null clears it, and such losses then post to netLossAccount.

Maximum string length: 127
Example:

"8300"

apAccount
string | null

Accounts Payable account: what the company owes suppliers. An approved received invoice books its expense against it. Provide an account CODE. Null clears it, and approved invoices then post no journals. Cannot be cleared while apClearingAccount is set.

Maximum string length: 127
Example:

"2000"

apClearingAccount
string | null

AP Clearing account, needed by the QuickBooks bill payment loop only: transactions that pay an invoice are coded here and the bill payment is recorded from it (a Bank type account in QuickBooks). Provide an account CODE, or null to clear it. Rejected with 400 unless the company also has an apAccount.

Maximum string length: 127
Example:

"1250"

booksLockDate
string | null

Books Lock Date: the last locked day as yyyy-MM-dd (UTC), or null to unlock the books. A manual journal dated on or before it can no longer be posted, edited or voided, and the opening balances can no longer be replaced or removed. Only an Owner or a Manager of the company may move it: a key owned by an Editor gets 403.

Maximum string length: 10
Example:

"2026-09-30"

lockTransactions
boolean

When true, also lock every unlocked transaction dated on or before the books lock date (the one sent in this request, else the stored one) in a background task, whose id comes back as lockTaskId. A locked transaction dated in the locked period cannot be unlocked until the lock date moves back.

Example:

true

financialYearEndMonth
integer

Financial year end: the month the financial year ends in, 1 (January) to 12 (December, the calendar year); the year ends on the last day of that month. It moves the year and quarter period presets of the dashboard (new reports and the VAT Report). Existing reports keep their dates.

Required range: 1 <= x <= 12
Example:

6

fullAccounting
boolean

Full Accounting switch. Display only: true shows the fiat accounting screens in the dashboard (Invoices & Tax, Journals, the financial statement tabs, the fiat settings), false hides them unless the company already uses them. It never changes a figure and never limits this API.

Example:

true

accounts
object[]

Replace the whole chart of accounts with this list (the dashboard CSV upload). Every code the transactions, rules and default account mappings reference must still be present or those references stop resolving at sync time. The previous chart is kept as a version in GET /company/accounts/history, so a mistake can be restored by re-sending that version. On a company connected to Xero, QuickBooks or Bexio, prefer the accounts refresh endpoints, which pull the chart from the platform.

Maximum array length: 5000

Response

Company updated successfully

success
enum<boolean>
required
Available options:
true
data
object
required
Last modified on June 4, 2026