UpsertComponentInput

Type: Input

Input for creating or updating a component

Fields

Name	Type	Default	Description
actualSubstrateId	SubstrateID		Actual substrate/paper ID
colors	ComponentColorInfoInput		Color specification for front and back
componentGroupId	ComponentGroupID		Parent component group ID (optional — leave nil for ungrouped components)
createdAt	ISO8601		Override creation timestamp (ISO8601). Honored only on create — passing on update is rejected.
description	String		Component description
desiredSubstrateId	SubstrateID		Desired substrate/paper ID
externalId	String		External system ID
finishedSize	JSON		Finished size after trimming (JSON)
finishing	FinishingSpecInput		Finishing specification (varnish, die, foil, emboss)
id	ComponentID		ID for update; omit for create
jobId	JobID!		Parent job ID (required)
kind	ComponentKind!		Component classification (required)
layout	ComponentLayoutInput		Layout specification with layers
media	JSON		Media/paper specification (JSON)
name	String!		Component name (required)
quantity	Int!		Number of units (required)
sortOrder	Int		Sort order (defaults to 0)
totalPages	Int		Total number of pages
updatedAt	ISO8601		Override update timestamp (ISO8601). Honored on create or update; defaults to now.