# update_draft_journal

`POST /api/v1/commands/update_draft_journal`

Base URL: `https://boringbooks.io`.



## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `currency` | `CurrencyInput` | no |  |
| `description` | string, nullable | no | Max length: `4000`. |
| `lines` | array of object | no | Min items: `1`. Max items: `100`. |
| `lines[].account_id` | string (uuid) | yes |  |
| `lines[].amount` | `AmountInput` | yes |  |
| `lines[].side` | string | yes | One of: `debit`, `credit`. |
| `lines[].dimensions` | object, nullable | no |  |
| `lines[].memo` | string, nullable | no | Max length: `4000`. |
| `posting_date` | string (date) | no |  |
| `rationale` | string, nullable | no | Max length: `4000`. |

Example:

```json
{
  "description": "Corrected description",
  "id": "44444444-4444-4444-8444-444444444444"
}
```

## Response (200)

| Field | Type | Required | Description |
|---|---|---|---|
| `id` | string (uuid) | yes |  |
| `status` | string | yes |  |

## Shared types

Fields typed with one of these names refer to it.

- `AmountInput` (string): An unsigned decimal magnitude as a string, greater than zero, in plain notation: digits with an optional fractional part, and no sign, exponent, or separators. "100" and "100.0" are accepted and normalized to the currency's scale ("100.00" for most currencies, "100" for JPY); more precision than the currency admits ("100.005" for USD, "100.5" for JPY) is rejected, never rounded.
- `CurrencyInput` (string): An ISO 4217 alphabetic currency code from the supported set. It must be the target ledger's functional currency: a different supported currency is refused with `foreign_currency_not_supported`, and a currency outside the supported set is rejected outright. The supported set is additive and may grow. One of: `AUD`, `CAD`, `CHF`, `EUR`, `GBP`, `JPY`, `USD`.

## Errors

Every error response is a single `error` object with a closed `type` and a refining
`code`. The codes, and the conventions every operation shares, are in
[llms-full.txt](https://boringbooks.io/llms-full.txt).