Patch Quote Line Item

patch

https://api.scalepad.com/quoter/v1/quotes/{quote_id}/sections/{section_id}/line-items/{line_item_id}

Patch a line item on a draft quote. Absent fields preserve the row.

Nested objects + recurring_interval are tri-state: omit = no
change, null = clear, populated = apply. {} → 422. Entity ref
id required non-empty when present. category cannot be
cleared. recurring_interval: "" → 422.

Response matches GET /v1/quotes/{quote_id}.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

quote_id

string

required

Quote ID.

section_id

string

required

Section ID that owns the line item.

line_item_id

string

required

Line item public identifier.

Body Params

PATCH payload for a single line item. Every top-level field is
optional; only the ones present in the request touch the stored
row. manufacturer, supplier, discount, and
recurring_interval accept JSON null to clear the field.
category cannot be cleared; sending null on category returns
422. {} on any nested object returns 422.

category

object

Category reference. ID-only resolution. Cannot be cleared —
sending null or {} returns 422.

code

string

length ≤ 50

SKU-style code. Max 50 characters.

description

string

Line item description. HTML.

discount

object | null

Line-level discount. Send null to clear the stored discount;
send an object with input_type and input_decimal to apply.
{} returns 422.

manufacturer

object | null

Manufacturer reference. Send null to clear the reference;
send {id: "..."} to set. {} or {id: ""} returns 422.

name

string

length ≤ 100

Line item display name. Max 100 characters.

quantity_decimal

string

Quantity. Decimal string. Must be strictly greater than zero;
fractional values are supported.

recurring_interval

string | null

enum

Recurring interval for the line. Send null to drop the line
back to one-time; send a non-empty enum value to set. Empty
string ("") returns 422. When non-null it must match the
parent quote's own recurring_interval.

Allowed:

sku

string

length ≤ 50

Supplier SKU. Max 50 characters.

supplier

object | null

Supplier reference. Send null to clear the reference; send
{id: "..."} to set. {} or {id: ""} returns 422.

taxable

boolean

Whether the line item participates in tax calculation.

unit_cost_decimal

string

Per-unit cost. Decimal string. Non-negative.

unit_price_decimal

string

Per-unit price. Decimal string. Non-negative.

Responses

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200Line item patched. Response reflects recomputed totals when a calc-affecting field changed.

400Malformed request body (unparseable JSON) or missing quote_id / section_id / line_item_id path parameter.

404Quote, section, or line item not found.

409Quote is not in draft state (already published).

422Validation failure. Failing rules come back located with the line_items[0].field prefix so callers can point at the offending field. Common cases include empty nested objects, empty entity-ref IDs, category: null (category cannot be cleared), and recurring_interval: "".