Organizations

Update the current organization

Organization settings update. Logo or color input updates the one shared firm identity used by reports, email, and HTML client pages; legacy profile fields remain accepted for compatibility. A request containing only managed-company autoPostEnabled requires ordinary company access (view:data), so any assigned firm staff member can activate Core AI posting or Tally AI for that company. Firm-workspace autoPostEnabled and every other organization setting remain owner-only (manage:billing). OAuth/agent credentials also require organizations:write. LedgerHQ owns the 1% best-guess AI category posting minimum. Legacy aiAutopostMinConfidence inputs are ignored compatibility no-ops. Response always includes appliedFields and ignoredDeprecatedFields receipts.

patch/organization

Request

  • Base URL: https://ledgerhq.pro/api/v1
  • URL: https://ledgerhq.pro/api/v1/organization
  • Auth: one of:
    • HTTP bearer and API key in header x-organization-id
    • HTTP bearer and API key in header x-organization-id

Request body

namestring
slugstring
countrystring nullable
logostring nullable
reportPrimaryColorstring
reportAccentColorstring
emailLogostring nullable
emailPrimaryColorstring nullable
emailAccentColorstring nullable
htmlLogostring nullable
whiteLogostring nullable

White raster firm logo. Does not replace the color logo.

htmlPrimaryColorstring nullable
htmlAccentColorstring nullable
businessTypestring nullable
defaultCurrencystring
fiscalYearStartMonthinteger
autoPostEnabledboolean

Activation switch for Core AI posting or Tally AI unattended work on the current firm or managed-company bookkeeping workspace.

codingEmailsEnabledboolean

Legacy compatibility input. It is ignored and never written; autoPostEnabled is the Tally AI activation switch for each bookkeeping workspace.

aiAutopostMinConfidenceinteger

Legacy compatibility input. It is accepted as an ignoredDeprecatedFields no-op; LedgerHQ uses a 1% best-guess posting minimum.

countryCodestring nullable
taxIdstring nullable
businessRegistrationNumberstring nullable
legalEntityTypestring nullable
addressStreetstring nullable
addressCitystring nullable
addressStatestring nullable
addressPostalCodestring nullable
addressCountrystring nullable
contactPhonestring nullable
contactEmailstring nullable
contactWebsitestring nullable
defaultPaymentTermsstring nullable
industrySectorstring nullable
referralSourcestring nullable
emailSenderNamestring

Firm workspace only. Name part of the firm's client email address (name@ledgerhq.pro) shown on request emails. Invalid or reserved names return 400; a name another firm uses returns 409.

Response

Updated organization with bookkeeping-workspace Core or Tally AI activation receipts

appliedFieldsstring[] required

Fields that were validated and persisted on this request

ignoredDeprecatedFieldsstring[] required

Legacy coding fields accepted for compatibility without mutation, including aiAutopostMinConfidence on every package and workspace

Changes

No recorded changes to this operation across all 3 revisions of this API.