v55

latestOpenAPI 3.0.3raw.githubusercontent.com2026-08-012046146.0 KB
Price Books

Delete price books

Delete price books and their associated pricing data with cascading effects on the hierarchy.

<h3>Cascading Deletion</h3>

When you delete a price book:

  • Child Price Books: All child price books in the hierarchy are automatically deleted
  • Associated Prices: All prices assigned to the deleted price book and its children are removed
  • Hierarchy Impact: The entire branch below the deleted price book is removed
<h3>Deletion Scenarios</h3>
  • Base Price Book: Deletes entire pricing hierarchy and all associated prices
  • Child Price Book: Deletes the specific price book and its children, but preserves sibling price books
  • Leaf Price Book: Deletes only the specified price book and its associated prices
<h3>Recovery Options</h3>

If a price book is deleted by mistake:

  • Time Window: You have up to one week to restore deleted price books
  • Restoration Method: Recreate the top-level parent price book using the original create payload
  • State Recovery: Price books and prices are restored to their state when deleted
  • Hierarchy Reconstruction: The entire hierarchy is rebuilt from the restoration payload
<h3>Best Practices</h3>
  • Backup Strategy: Keep copies of price book configurations for recovery
  • Validation: Verify hierarchy structure before deletion
  • Impact Assessment: Review associated prices before deleting price books
post/v1/catalog/price-books/delete

Headers

Content-Type'application/json' required
Authorizationstring required

Authorization Bearer token.

Content-Encoding'gzip'

Use this header if the payload is compressed with gzip.

Request body

priceBookIdstring required

Price book id

Response

All items in the request are accepted for further processing.