---
title: "Replace a consolidation group"
method: PATCH
path: "/reports/consolidations/{id}"
tags: ["Reports"]
---

# Replace a consolidation group

`PATCH /reports/consolidations/{id}`

## Request

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

Replaces the name, companies, eliminated accounts, and account headings. Report setup only; never changes the books.

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `name` string, required
  - `companies` object[], required: Two or three member client companies in column order
    - `organizationId` string, uuid, required
    - `label` string: Optional short column heading
  - `eliminatedAccounts` object[]: Intercompany accounts eliminated across companies, matched by type and name (case and spacing ignored)
    - `type` 'asset' | 'liability' | 'equity' | 'revenue' | 'expense', required
    - `name` string, required
  - `accountHeadings` object[]: Group-only headings that combine differently named accounts into one report row; company books are not changed. An account belongs to at most one heading, and eliminating an account in a heading eliminates the heading
    - `type` 'asset' | 'liability' | 'equity' | 'revenue' | 'expense', required
    - `name` string, required: Heading shown on the report
    - `accounts` string[], required: Account names to combine, case and spacing ignored

## Response `200`

Saved group

## Other responses

- `400`: Invalid group or a company listed twice
- `403`: Firm staff with report management permission is required
- `404`: Group or company not found
- `default`: Error response

---

[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/01c3e57d281f?raw)