---
title: "WRITE — Builder Mode: put forecast lines in CASH > Cash forecasts, as committed movements on a bank account and a day"
method: POST
path: "/api/v1/cash_forecast_lines_put"
---

# WRITE — Builder Mode: put forecast lines in CASH > Cash forecasts, as committed movements on a bank account and a day

`POST /api/v1/cash_forecast_lines_put`

## Request

- Base URL: `https://k-phi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://k-phi.com/api/v1/cash_forecast_lines_put`
- Auth: HTTP bearer

WRITE — Builder Mode: put forecast lines in CASH > Cash forecasts, as committed movements on a bank account and a day. Each row: value_date (YYYY-MM-DD), amount (signed: + in, - out), currency (the account's), account_id (from kphi_bank_position); optional description, reference, third_party, third_entity (a group company: the mirror line is created on its default account), recur_freq (weekly | monthly | quarterly | yearly) with recur_until. All or nothing: one bad row saves nothing and says which and why. replace: true first removes every line this extension put there before (a forecast that is recomputed). The Cash worksheet, the CASH forecast and Claude read the lines at once.

## Request body

- object
  - `rows` object[], required: Up to 2000 lines
    - `value_date` string, required
    - `amount` number, required
    - `currency` string, required
    - `account_id` string, required
    - `description` string
    - `reference` string
    - `third_party` string
    - `third_entity` string
    - `recur_freq` 'weekly' | 'monthly' | 'quarterly' | 'yearly'
    - `recur_until` string
  - `replace` boolean: Remove this extension's previous lines first

## Response `200`

OK

- object
  - `data` object
  - `meta` object
    - `api` string
    - `capability` string
    - `at` string

## Other responses

- `401`: No or invalid credential
- `403`: Scope, extension or Builder Mode refused
- `422`: The capability refused the input
- `429`: Rate or daily quota reached

---

[API](https://skmtc.dev/k-phi/apis/k-api.md) · [All operations](https://skmtc.dev/k-phi/apis/k-api/llms.txt) · [OpenAPI document](https://skmtc.dev/k-phi/apis/k-api/revisions/60b28690ec35?raw)