---
title: "Updates a journal entry"
method: PUT
path: "/journal-entries/{journal_entry_id}"
tags: ["Journal Entries"]
---

# Updates a journal entry

`PUT /journal-entries/{journal_entry_id}`

Replaces the lines and header metadata on an existing manual journal entry, subject to the same balancing rules as creation.
Always include the complete line list retrieved beforehand because partial payloads can clear fields the API treats as optional.

## Path parameters

- `journal_entry_id` string, required

## Request body

- UpdateJournalEntryRequest
  - `name` string, required
  - `currency` string, required — Currency code following ISO-4217
  - `items` JournalEntryItemRequest[], required
    - `description` string
    - `amount` RoundedMonetaryAmount, required — A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
      - `amount` string, required — Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
      - `currency` string, required — Currency code following ISO-4217
    - `account_code` string, required — The account code found in the Chart of Accounts
    - `side` 'DEBIT' | 'CREDIT', required
    - `fields` object[]
      - `field_id` string, uuid, required
      - `field_value_id` string, uuid, required
    - `vat_code` string — Code or description of an existing VAT rate for the journal entry subsidiary's country. When provided, vat_type is required. VAT is always treated as inclusive.
    - `vat_type` string — VAT reporting type for this journal entry line. Required when vat_code is provided. Accepts Revenue, Revenues, Expense, or Expenses case-insensitively.
  - `date` string, date, required
  - `reversal_date` string, date
  - `attachmentUrl` string, uri
  - `exchange_rate` ExchangeRate
    - `base` string, required — Currency code following ISO-4217
    - `target` string, required — Currency code following ISO-4217
    - `rate` string, required
    - `date` string, date, required

## Response `200`

OK

- JournalEntry
  - `id` string, uuid, required
  - `subsidiary_id` string, uuid
  - `name` string, required
  - `currency` string, required — Currency code following ISO-4217
  - `related_entity` JournalEntryRelatedEntity
    - `id` string, uuid, required
    - `type` 'CUSTOMER' | 'VENDOR', required
  - `items` JournalEntryItem[], required
    - `id` string, uuid, required
    - `description` string
    - `amount` RoundedMonetaryAmount, required — A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
      - `amount` string, required — Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
      - `currency` string, required — Currency code following ISO-4217
    - `original_transaction_amount` RoundedMonetaryAmount — A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
      - `amount` string, required — Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
      - `currency` string, required — Currency code following ISO-4217
    - `account_id` string, uuid, required — Immutable account identifier.
    - `account_code` string, required — The account code found in the Chart of Accounts
    - `side` 'DEBIT' | 'CREDIT', required
    - `fields` object[]
      - `field_id` string, uuid, required
      - `field_value_id` string, uuid, required
  - `date` string, date, required — The date this journal entry was posted to the general ledger.
  - `reversal_date` string, date
  - `attachmentUrl` string, uri
  - `exchange_rate` ExchangeRate
    - `base` string, required — Currency code following ISO-4217
    - `target` string, required — Currency code following ISO-4217
    - `rate` string, required
    - `date` string, date, required
  - `updated_at` string, date-time, required — ISO 8601 timestamp in UTC timezone (must end with 'Z')

## Other responses

- `default` — Error

---

[API](https://skmtc.net/rillet/apis/rillet-accounting-api.md) · [All operations](https://skmtc.net/rillet/apis/rillet-accounting-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rillet/rillet-accounting-api/versions/a2ab794dd5f2/schema)