Skip to content

Manufactured components

Partial update of a manufactured component. Two equivalent lookups:

  • Call by id — Fairly Made id (UUID v4) from the 201 response
  • Call by unique identifier — your uniqueIdentifier from creation

Updates are locked once traceability collection starts. If you run traceability collection (SDC) with Fairly Made, a PATCH on this entity is taken into account only until the collection is launched for its uniqueIdentifier. Collection can be launched only once per uniqueIdentifier — after that launch, PATCH calls on this entity are no longer taken into account. (Brand products are the exception: they can be updated at any time.)

Operations

Call by unique identifier

Request

Call by: uniqueIdentifier — your internal reference from POST /manufactured-components.

Partial update with the same body and rules as Call by id. If the component belongs to another client → 404 (ManufacturedComponentNotFoundByUniqueIdentifier).

Path
uniqueIdentifierstring, non-emptyrequired

Your resource uniqueIdentifier (same value as on the corresponding POST endpoint). Any non-empty URL-encoded string is accepted; it is not validated as a UUID.

Bodyapplication/jsonrequired
referencestring
ownerKindstring or null
Value:"SUPPLIER"
ownerIdstring or null, (uuid)

System UUID of the supplier owner. Provide exactly one of ownerId or ownerUniqueIdentifier when setting an owner.

ownerUniqueIdentifierstring or null

Client uniqueIdentifier of the supplier owner. Requires ownerKind = SUPPLIER. Mutually exclusive with ownerId.

addressobject or null(Address)

Postal address of an entity.

categorystring

Component category; same allowed values as POST /manufactured-components.

compositionsArray of objects, non-empty(Composition)
stepsArray of objects(ComponentStep)
purchasedItemsArray of objects(ManufacturedComponentPatchPurchasedItem)
usedComponentsArray of objects(UsedComponent)
usedMaterialsArray of objects(ManufacturedComponentPatchUsedMaterial)
curl -i -X PATCH \
  'https://doc.api.fairlymade.com/_mock/swagger-fairlymadeapi-v3/manufactured-components/by-unique-identifier/{uniqueIdentifier}' \
  -H 'Content-Type: application/json' \
  -d '{}'

Responses

Updated manufactured component record (full DTO).

Bodyapplication/json
property name*anyadditional property
Response
{}