Delete Items from a Proposal
DELETE /public/proposals//items — Removes one or more items from a proposal.
ItemIds, repeating the query parameter once per id.
Every id must belong to the proposal and appear only once — an unknown id or a repeated one returns 404, and nothing is deleted. There is no partial delete.
IncludeAttachments decides what happens to the items nested under those being deleted. It defaults to false, which keeps them: they survive as top-level items in the same area option, taking the position their parent held. Pass true to delete them along with their parent.
200 or 204; treat both as deleted. Along with refresh item costs, this is one of two item endpoints with no response body, so re-fetch get proposal if you need the remaining items.0 with update quantity instead.
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).
Query Parameters
Ids of the proposal items to delete. Each id must belong to the proposal, and a repeated id returns 404 rather than being ignored.
(Optional) Also remove the items nested under each deleted item. Defaults to false - nested items are then kept and promoted to top-level items in the same area option.
Response
Success (no body).