Update Proposal Item Quantity
POST /public/proposals//items//qty — Sets the quantity of a proposal item. Fractional values and zero are allowed.
Quantity of a proposal item. Fractional values are supported and stored rounded to 2 decimals, so 5.5 hours of labor is a valid quantity.
A quantity of 0 is allowed and keeps the item in the proposal at a zero total — use delete items to remove it.
IncludeAttachments rescales the items nested under this one proportionally rather than setting them to the same number. Going from 2 to 6 multiplies every nested quantity by 3, so a child at 1 becomes 3, rounded to 2 decimals. A child already at 0 stays at 0, and if the parent’s current quantity is 0 there is no factor to apply, so only the parent changes. Defaults to false.Authorizations
Portal application identifier used as part of HMAC-authenticated API requests.
Portal user API key used together with the HMAC signature headers.
Timestamp header included in the signed request to prevent replay attacks.
HMAC-SHA256 signature for the request, calculated over the canonical string defined in the authentication docs.
Headers
Accept Header
application/json Path Parameters
Unique ID of the proposal (not the proposal number).
Id of the proposal item to update. Must belong to the proposal.
Body
Proposals Service
New quantity for the item, stored rounded to 2 decimals. Zero is allowed and leaves the item in place - use the delete endpoint to remove it.
When true, the items nested under this item are rescaled by the same factor as this item, rather than being set to the same quantity. For example, changing this item from 2 to 6 multiplies every nested quantity by 3, so a nested item at 1 becomes 3. If this item's current quantity is zero there is no factor to apply and only this item changes. Defaults to false.
Response
Success
Unique numeric identifier of the proposal item
Identifier of the catalog, labor, custom, or fee item this proposal item was created from
UTC timestamp when the proposal item was created
Quantity of the proposal item
Identifier of the parent item when this item is nested under another item
Part, Labor, CustomItem, Fee UTC timestamp when the proposal item was last modified
Brand name of the item
Model value of the item
Name of a Labor item
Short description shown for the proposal item
Client-facing note for the proposal item
Image URL of the item
MSRP amount of the item
Sell price for the proposal item
Supplier cost for the proposal item
UTC timestamp when the supplier cost was last updated
Display name of the supplier assigned to the item.
Total amount for a proposal item
Whether the proposal item is tax exempt
Whether the proposal item is a recurring service
Linked orders created from this proposal item