---
title: "Move a settled personal row into a linked company's books"
method: POST
path: "/families/{id}/personal/transactions/{eventId}/move"
tags: ["Families"]
---

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

`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`

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.

## Path parameters

- `id` string, uuid, required
- `eventId` string, required

## Request body

- object
  - `companyId` string, uuid, required
  - `accountId` string, uuid, required: Company account for the cost or income
  - `ownerAccountId` string, uuid, required: Company equity or liability account for the owner side
  - `description` string

## Response `200`

Success

- object
  - `success` boolean
  - `familyId` string, uuid
  - `eventId` string
  - `companyId` string, uuid
  - `journalEntryId` string, uuid

## Other responses

- `403`: Firm staff or required permission missing
- `404`: Record not found or not accessible
- `409`: Archived family, last-member removal, identity conflict, already-linked member, explicit owner selection required, or redundant administrator assignment

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)