---
title: "Put Journal Header Fields"
method: PUT
path: "/companies/{company_id}/journal-header-fields"
tags: ["journal-export"]
---

# Put Journal Header Fields

`PUT /companies/{company_id}/journal-header-fields`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/companies/{company_id}/journal-header-fields`
- Auth: none declared

Replace the company's header-field config (accountant). 422 on an invalid config.

## Path parameters

- `company_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Request body

- HeaderFieldsPutRequest: PUT body for ``/companies/{cid}/journal-header-fields`` — the ordered field list.
  - `fields` HeaderFieldConfigIn[]
    - `key` string, required
    - `label` string, required
    - `scope` string
    - `enabled` boolean
    - `source_type` string, required
    - `constant_value` string, nullable
    - `derived_token` string, nullable
    - `accountant_field` string, nullable

## Response `200`

Successful Response

- HeaderFieldsResponse: GET response: the company's configured fields + catalog + curated defaults.
  - `fields` HeaderFieldConfigOut[]
    - `key` string, required
    - `label` string, required
    - `scope` string
    - `enabled` boolean
    - `source_type` string, required
    - `constant_value` string, nullable
    - `derived_token` string, nullable
    - `accountant_field` string, nullable
  - `catalog` HeaderFieldCatalogEntryOut[]
    - `key` string, required
    - `default_label` string, required
    - `scope` string, required
    - `value_type` string, required
    - `max_length` integer, nullable
    - `allowed_values` string[], nullable
    - `importable` boolean
    - `is_abacus_mapped` boolean
    - `abacus_xml_element` string, nullable
    - `suggested_source_type` string, required
    - `allowed_source_types` string[]
  - `defaults` HeaderFieldConfigOut[]
    - `key` string, required
    - `label` string, required
    - `scope` string
    - `enabled` boolean
    - `source_type` string, required
    - `constant_value` string, nullable
    - `derived_token` string, nullable
    - `accountant_field` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zeno-works/apis/zeno-api.md) · [All operations](https://skmtc.dev/zeno-works/apis/zeno-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zeno-works/apis/zeno-api/revisions/1eb93dde146c?raw)