← All types
ProductionIn Input object

UpsertComponentInput

Input for creating or updating a component

Fields

ID for update; omit for create

jobId

JobID!Required

Parent job ID (required)

Parent component group ID (optional — leave nil for ungrouped components)

Internal component number

External system ID

HTTP(S) link to this record in the external system. Requires an external identity. Omit to preserve the existing link, or pass null to clear it. Removing the external identity also removes its link.

name

String!Required

Component name (required)

Component description

Component classification (required)

Possible values (9)
CONTENT

General content pages

COVER

Cover component

INSERT

Bound-in insert

MAIN

Main component of a single-component job

TEXT

Text block pages

DUST_JACKET

Dust jacket wrapper for case-bound books

ENDPAPER

Endpapers/pastedowns

OUTSERT

Outsert/wrap-around component

OTHER

Uncategorized component

quantity

Int!Required

Number of units (required)

sortOrder

IntOptional

Sort order (defaults to 0)

Override creation timestamp (ISO8601). Honored only on create — passing on update is rejected.

Override update timestamp (ISO8601). Honored on create or update; defaults to now.

Total number of pages

Desired substrate/paper ID

Actual substrate/paper ID

Color specification for front and back. Omit to leave it unchanged; null clears it.

Layout specification with layers. Omit to leave it unchanged; null clears it.

Media/paper specification. Omit to leave it unchanged; null clears it.

Finished size after trimming (width and height). Omit to leave it unchanged; null clears it.

Finishing specification (varnish, die, foil, emboss). Omit to leave it unchanged; null clears it.

Referenced by (1)
Exact type SDL
"""Input for creating or updating a component"""
input UpsertComponentInput {
  """ID for update; omit for create"""
  id: ComponentID
  """Parent job ID (required)"""
  jobId: JobID!
  """
  Parent component group ID (optional — leave nil for ungrouped components)
  """
  componentGroupId: ComponentGroupID
  """Internal component number"""
  componentNumber: String
  """External system ID"""
  externalId: String
  """
  HTTP(S) link to this record in the external system. Requires an external identity. Omit to preserve the existing link, or pass null to clear it. Removing the external identity also removes its link.
  """
  externalUrl: String
  """Component name (required)"""
  name: String!
  """Component description"""
  description: String
  """Component classification (required)"""
  kind: ComponentKind!
  """Number of units (required)"""
  quantity: Int!
  """Sort order (defaults to 0)"""
  sortOrder: Int
  """
  Override creation timestamp (ISO8601). Honored only on create — passing on update is rejected.
  """
  createdAt: ISO8601
  """
  Override update timestamp (ISO8601). Honored on create or update; defaults to now.
  """
  updatedAt: ISO8601
  """Total number of pages"""
  totalPages: Int
  """Desired substrate/paper ID"""
  desiredSubstrateId: SubstrateID
  """Actual substrate/paper ID"""
  actualSubstrateId: SubstrateID
  """
  Color specification for front and back. Omit to leave it unchanged; null clears it.
  """
  colors: ComponentColorInfoInput
  """
  Layout specification with layers. Omit to leave it unchanged; null clears it.
  """
  layout: ComponentLayoutInput
  """Media/paper specification. Omit to leave it unchanged; null clears it."""
  media: MediaInput
  """
  Finished size after trimming (width and height). Omit to leave it unchanged; null clears it.
  """
  finishedSize: MediaInput
  """
  Finishing specification (varnish, die, foil, emboss). Omit to leave it unchanged; null clears it.
  """
  finishing: FinishingSpecInput
}