Skip to main content
PATCH
Select Source

Path Parameters

workspaceId
string
required
projectId
string
required
id
string
required

Body

application/json
version
number
required
estimateColumnsAttributes
object

Supplier (source-owned) column values typed on the Estimate and not saved yet, by column slug. When the line leaves its Estimate for this vendor, a field the vendor leaves empty takes this value instead of the saved estimate, and it is handled like the kept estimate (written to a New from project vendor, staged or proposed on a Ready to use one); a field the vendor fills keeps the vendor value. Ignored by every other choice: vendor to vendor, back to the Estimate, or the source the line already stands on (which writes nothing). Validated as a PATCH …/items/{id} of those columns is; a value it would refuse answers 400 INVALID_COLUMNS_ATTRIBUTES and nothing is written.

catalogFamilySourceId
string | null

Response

200 - application/json
notes
string
required

Item-owned notes, separate from instructions.

id
string
required
projectId
string
required
projectItemSlotId
string | null
required
name
string
required
catalogFamilyId
string
required

BigInt string

catalogItemId
string
required

BigInt string

materialFinish
object | null
required
columnsAttributes
object
required
formulaAssignments
object
required
effectiveFormulaAssignments
object
required
effectiveTaxSettings
object | null
required
inheritedTaxSettings
object | null
required
formulaResults
object
required
purchaseQuantityOverride
string | null
required
purchasingUnit
enum<string>
required
Available options:
units,
packages
sourceMeta
object | null
required
isPrimary
boolean
required
optionStatus
enum<string>
required
Available options:
active,
cancelled
catalogConnectionMode
enum<string>
required

live participates in catalog synchronization; saved is a project-only saved catalog version

Available options:
live,
saved
savedAt
string<date-time> | null
required
selectedSource
object | null
required
collectionApplication
object | null
required
categoryId
string
required
productTypeId
string | null
required
kind
enum<string>
required
Available options:
option,
component
catalogFamilyStatus
enum<string> | null
required

CatalogFamily.status — drives FE Push/Pull button visibility

Available options:
draft,
new_from_project,
new_from_collection,
ready_to_use,
null
catalogSourceLifecycle
object | null
required
catalogFamilyItemType
enum<string> | null
required

CatalogFamily.itemType for the linked live Catalog family

Available options:
default,
material,
null
catalogDecisionEventIds
string[]
required
refNumber
string | null
required
affectedParentPiIds
string[]
required

Parent PI ids whose parts list embeds this PI as a row. Set only when the mutated PI is a component; FE invalidates each parent PI parts-list cache entry. Empty array for options.

version
number
required
createdAt
string
required
updatedAt
string
required
keptFromEstimate
string[]
required

Supplier (source-owned) column slugs the chosen vendor left empty when the line left its Estimate (its current Offer names no supplier, the chosen one does), so the line kept its estimate there. A field is listed whether or not the line held an estimate value in it. Empty for every other choice: vendor to vendor, back to the Estimate, or the source the line already stands on.

pricingSettings
object
required
slotColumnsAttributes
object | null
required
catalogFamilyDiscontinued
boolean
required
coreChangePolicy
object
required
catalogFamilySourceId
string | null
softCostOverrides
object
effectiveSoftCosts
object[]
syncStateCache
object | null
affectedCatalogFamilyId
string | null
componentBuildCostBreakdown
object | null