Move Proposal Items
POST /public/proposals//items/move — Moves one or more items to a different area option within the same proposal.
ProposalItemIds and the target in DestinationAreaOptionId — one destination per call, unlike copy items. Both the destination option and every item must belong to the proposal, and a repeated id in ProposalItemIds returns 400 rather than being ignored.
Moved items are appended to the end of the destination option. Every item in a single call is given the same position in the destination, so if the order between them matters, move them one call at a time.
Move a parent to move its whole group. Sending a nested item’s own id moves just that item, and while MoveNestedItems is left at its default its parentId keeps pointing at a parent that now sits in the other area option.
The response lists the targeted items and their children, including children that stayed behind.
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).
Body
Proposals Service
Area option to move the items to. Must belong to the proposal.
Ids of the proposal items to move. Each item must belong to the proposal, and duplicate ids return 400 rather than being ignored.
(Optional) Whether nested items move with their parent. Defaults to true. When false, they stay in the old area option and become top-level items there.
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