Tools
Create bill
Save a bill of materials in Bomgrove with part numbers, descriptions, quantities, and units. Use parent part numbers for multilevel assemblies. Validates the full assembly before saving. Returns an immutable first revision and rolled-up leaf component totals. Each successful save counts as one BOM revision.
curl https://api.bomgrove.com/v1/create_bill \
-H "Authorization: Bearer $API_KEY" \
-d '{"name":"your name","components":[{"part_number":"your part number","description":"your description","quantity":0,"unit":"your unit"}]}'Input
| Field | Type | Description |
|---|---|---|
name (required) | string | Name of this bill of materials. |
root_part_number | string | Top-level assembly. Defaults to ASSEMBLY. |
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. |
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. |