Revise bill | Bomgrove

Save a distinct revision of an existing Bomgrove bill. Submit the complete replacement component list and latest revision ID. Returns added, removed, and changed relationships with before and after values. Previous revisions stay unchanged. Invalid components, circular dependencies, and stale bases are refused before saving. Each successful save counts as one BOM revision.

curl https://api.bomgrove.com/v1/revise_bill \
  -H "Authorization: Bearer $API_KEY" \
  -d '{"bill_id":"your bill id","base_revision_id":"your base revision id","components":[{"part_number":"your part number","description":"your description","quantity":0,"unit":"your unit"}]}'

Input

Field	Type	Description
`bill_id` (required)	string	Bill ID returned by Create bill.
`base_revision_id` (required)	string	Latest revision ID. A stale base is refused without saving.
`name`	string	Optional replacement bill name.
`components` (required)	array	Complete replacement component list, not a patch. Include unchanged rows. Omit rows to remove them. The root assembly stays the same.
`note`	string	Optional revision note.

Output

Field	Type	Description
`bill_id` (required)	string	Stable bill ID.
`revision_id` (required)	string	Immutable revision ID.
`revision_number` (required)	integer
`previous_revision_id` (required)	string	Empty on the first revision.
`name` (required)	string	Bill name.
`root_part_number` (required)	string	Top-level assembly part number.
`note` (required)	string
`created_at` (required)	string	Revision creation time in UTC.
`components` (required)	array	Complete BOM as assembly relationships. Each row is one part per parent. A part with children is a subassembly. All parents must connect to the root. Repeated part numbers must have the same description and unit. An empty list is allowed.
`totals` (required)	array
`changes` (required)	array
`summary` (required)	string	Relationship counts and any bill name change.