---
title: "Replaces the lines items in a payable"
method: PUT
path: "/payables/{payable_id}/line_items"
tags: ["Payable line items"]
---

# Replaces the lines items in a payable

`PUT /payables/{payable_id}/line_items`

## Request

- Base URL: `https://api.sandbox.monite.com/v1`
- URL: `https://api.sandbox.monite.com/v1/payables/{payable_id}/line_items`
- Auth: HTTP bearer

Replaces the information of all line items of a specific payable.

Related guide: [Replace all line items](https://docs.monite.com/accounts-payable/payables/line-items#replace-all-line-items)

See also:

[Manage line items](https://docs.monite.com/accounts-payable/payables/line-items)

[Collect payables](https://docs.monite.com/accounts-payable/payables/collect)

## Path parameters

- `payable_id` string, required

## Headers

- `x-monite-version` string, required
- `x-monite-entity-id` string, required

## Request body

- object
  - `data` LineItemInternalRequest[], required
    - `accounting_tax_rate_id` string, uuid: ID of the tax rate reference used for accounting integration. May be used to override auto-picked tax rate reference in accounting platform in case of any platform-specific constraints.
    - `description` string: Description of the product.
    - `ledger_account_id` string, uuid: ID of the account record used to store bookkeeping entries for balance-sheet and income-statement transactions.
    - `name` string: Name of the product.
    - `quantity` number, double: The quantity of each of the goods, materials, or services listed in the payable.
    - `subtotal` integer
    - `tax` integer: VAT rate in percent [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.
    - `total` integer
    - `unit` string: The unit of the product
    - `unit_price` integer: The unit price of the product, in [minor units](https://docs.monite.com/references/currencies#minor-units). For example, $12.50 is represented as 1250.

## Response `200`

Successful Response

- LineItemsReplaceResponse
  - `data` LineItemResponse[], required
    - `id` string, uuid, required
    - `accounting_tax_rate_id` string, uuid: ID of the tax rate reference used for accounting integartion. May be used to override auto-picked tax rate reference in accounting platform in case of any platform-specific constraints.
    - `description` string: Description of the product.
    - `ledger_account_id` string, uuid: ID of the account record used to store bookkeeping entries for balance-sheet and income-statement transactions.
    - `name` string: Name of the product.
    - `ocr_set_quantity_to_one` boolean: Indicates whether the item's `unit_price` and `quantity` were adjusted by OCR.
    - `payable_id` string, uuid, required
    - `quantity` number, double: The quantity of each of the goods, materials, or services listed in the payable.
    - `subtotal` integer: The subtotal (excluding VAT), in [minor units](https://docs.monite.com/references/currencies#minor-units).
    - `tax` integer: VAT rate in percent [minor units](https://docs.monite.com/references/currencies#minor-units). Example: 12.5% is 1250.
    - `tax_amount` integer: Tax amount in [minor units](https://docs.monite.com/references/currencies#minor-units). For example, $12.50 is represented as 1250.
    - `total` integer: The actual price of the product.
    - `unit` string: The unit of the product
    - `unit_price` integer: The unit price of the product, in [minor units](https://docs.monite.com/references/currencies#minor-units). For example, $12.50 is represented as 1250.
    - `was_created_by_user_id` string, uuid: ID of the user who created the tag.

## Other responses

- `400`: Bad Request
- `401`: The `Authorization` header is missing or contains an invalid or expired access token. See [Authentication](https://docs.monite.com/api/concepts/authentication) to learn how to authenticate API calls.
- `403`: The specified access token does not have permissions to perform this operation.
- `404`: A payable with the specified ID was not found.
- `406`: Not Acceptable
- `409`: Business logic error
- `422`: Validation Error
- `429`: API rate limit has been exceeded. Check the response headers for the rate limit information.

---

[API](https://skmtc.dev/monite/apis/monite-2.md) - [All operations](https://skmtc.dev/monite/apis/monite-2/llms.txt) - [OpenAPI document](https://skmtc.dev/monite/apis/monite-2/revisions/4299ccf95edb?raw)