Families

Move a settled personal row into a linked company's books

Firm-side family relationships only. Select the firm with x-organization-id. Owners, Admins and Staff Admins access all firm families; Staff Members need independent family assignment. Company access does not grant family access. OAuth requires the broad mcp grant, not a narrow banking scope; API keys retain ordinary agent permission scopes. No accounting organizations, portal grants, bank changes, invitations or charges are created. Writes require ordinary firm write entitlement. Cross-firm and inaccessible IDs return 404. Exception: this operation posts one journal entry in the chosen company through the shared posting service: the company account takes the row's amount and the owner equity or liability account takes the other side. Each row moves once (409 if already moved or not settled). Requires entry permission.

post/families/{id}/personal/transactions/{eventId}/move

Request

  • Base URL: https://ledgerhq.pro/api/v1
  • URL: https://ledgerhq.pro/api/v1/families/{id}/personal/transactions/{eventId}/move
  • Auth: one of:
    • HTTP bearer and API key in header x-organization-id
    • HTTP bearer and API key in header x-organization-id

Path parameters

idstring uuid required
eventIdstring required

Request body

companyIdstring uuid required
accountIdstring uuid required

Company account for the cost or income

ownerAccountIdstring uuid required

Company equity or liability account for the owner side

descriptionstring

Response

Success

successboolean
familyIdstring uuid
eventIdstring
companyIdstring uuid
journalEntryIdstring uuid

Changes

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