---
title: "Create or update a company brief section"
method: PUT
path: "/companies/{companyId}/brief/sections/{sectionKey}"
tags: ["Company brief"]
---

# Create or update a company brief section

`PUT /companies/{companyId}/brief/sections/{sectionKey}`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/companies/{companyId}/brief/sections/{sectionKey}`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Writes an answered standard or custom brief section. For an existing section, pass its expectedUpdatedAt value to prevent overwriting a concurrent edit.

## Path parameters

- `companyId` string, uuid, required
- `sectionKey` string, required

## Request body

- object
  - `title` string, nullable
  - `content` string, required
  - `expectedUpdatedAt` string, date-time, nullable

## Response `200`

Saved company brief section

- CompanyBriefSection
  - `id` string, uuid, nullable
  - `sectionKey` string, required
  - `title` string, required
  - `question` string, nullable
  - `guidance` string, nullable
  - `isStandard` boolean, required
  - `status` 'unasked' | 'answered' | 'deferred' | 'not_applicable', required
  - `content` string, nullable
  - `source` 'accountant' | 'tally_interview' | 'document' | 'null', nullable
  - `lastEditedSource` 'accountant' | 'tally_interview' | 'document' | 'null', nullable
  - `updatedByUserId` string, uuid, nullable
  - `lastAskedAt` string, date-time, nullable
  - `deferredUntil` string, date, nullable
  - `manualOnly` boolean, required
  - `createdAt` string, date-time, nullable
  - `updatedAt` string, date-time, nullable

## Other responses

- `409`: Concurrent edit conflict
- `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/9a8269f0a586?raw)