Update Proposal Item Sell Price
POST /public/proposals//items//sellprice — Sets an absolute sell price or a percentage-based sell price on a proposal item.
SellPrice or a SellPercentage plus SellPercentageBasis. Exactly one of the two forms is required: supplying both, neither, or a percentage without its basis returns 400.
The two forms replace each other. Writing an absolute price clears any stored percentage and basis; writing a percentage clears any stored absolute price.
Percentages are whole numbers — 15 means 15%, with the resulting price rounded to 2 decimals.
CostOfSellPrice belongs to update cost and must not be used here.
SetDefault also saves the price in the catalog so later proposals start with it — but only an absolute price is saved for a Part, and a percentage-based update instead clears whatever price was saved there before. Labor, CustomItem, and Fee items keep the price, percentage, and basis on their library item. UpdateAllInstances applies the change to the proposal’s other items from the same source item that share its item type, in any area option.
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
Absolute per-unit sell price, mutually exclusive with sellPercentage. Supplying it clears any stored percentage and basis.
Sell price as a whole percent of the chosen basis (15 means 15%), with the resulting price rounded to 2 decimals. Requires sellPercentageBasis, is mutually exclusive with sellPrice, and clears any stored absolute price.
ProposalTotal, PartTotal, LaborTotal, AreaTotal, PartsInAreaTotal, LaborInAreaTotal, CostOfSellPrice When true, also save this sell price in the catalog so later proposals start with it. For a Part, only an absolute price is saved: a percentage-based update saves no price and clears any price saved there before. For a Labor, CustomItem, or Fee item, the price, percentage, and basis are saved on the library item. Defaults to false.
When true, the same change is applied to the proposal's other items that come from the same catalog item and have the same item type, in any area option. 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