← API reference
CANONICAL TYPE REFERENCE

UpsertSubstrateInput

Input for creating or updating a substrate

Substrate ID — omit to create, provide to update

External system identifier for integration

nameString!

Display name of the substrate

codeString

Internal catalog code

Cached substrate designation used by an external system

Supplier's own product code

Reference to the supplier record

Paper mill or manufacturer name

brandString

Commercial brand or product line name

Physical form: roll or sheet stock

JDF media type classification

ISO 12647 paper substrate classification (PS1–PS8)

Sheet or roll width in mm

Sheet height or roll length; supply a Length value with its unit, or omit when unknown.

Paper weight with its unit: gsm, or pounds at a named basis sheet. It is stored as given, so a weight entered at its own basis keeps it.

Caliper thickness in mm

Surface coating per side: 1 element (both sides) or 2 elements [front, back]

Paper grain direction

Which sides of the media can be printed

Transparency level of the media

Printing technology compatibility

Paper stock type classification

Surface texture or finish

Base color of the media

Factory-applied coatings already on the media

shrinkIndex[Float!]

Shrink compensation factors [x, y] as percentages

ISO brightness percentage (0–100)

CIE whiteness index

Paper grade classification number

Corrugated board flute type per JDF specification

Percentage of recycled content (0–100)

Whether this substrate is supplied by the buyer

Moisture content percentage (0–100)

Supplier lead time in calendar days

isActiveBoolean

Whether this substrate is available for use

Minimum stock level before reorder is triggered

Unit of measure for the reorder threshold

Cost per unit in the specified currency

Currency code for unitCost

notesString

Free-text notes

View exact SDL
"""Input for creating or updating a substrate"""
input UpsertSubstrateInput {
  """Substrate ID — omit to create, provide to update"""
  id: SubstrateID
  """External system identifier for integration"""
  externalId: String
  """Display name of the substrate"""
  name: String!
  """Internal catalog code"""
  code: String
  """Cached substrate designation used by an external system"""
  externalCode: String
  """Supplier's own product code"""
  supplierCode: String
  """Reference to the supplier record"""
  supplierId: SupplierID
  """Paper mill or manufacturer name"""
  manufacturer: String
  """Commercial brand or product line name"""
  brand: String
  """Physical form: roll or sheet stock"""
  kind: MediaKind
  """JDF media type classification"""
  mediaType: MediaType
  """ISO 12647 paper substrate classification (PS1–PS8)"""
  isoPaperSubstrate: ISOPaperSubstrate
  """Sheet or roll width in mm"""
  width: LengthInput
  """
  Sheet height or roll length; supply a Length value with its unit, or omit when unknown.
  """
  height: LengthInput
  """
  Paper weight with its unit: gsm, or pounds at a named basis sheet. It is stored as given, so a weight entered at its own basis keeps it.
  """
  weight: PaperWeightInput
  """Caliper thickness in mm"""
  thickness: LengthInput
  """
  Surface coating per side: 1 element (both sides) or 2 elements [front, back]
  """
  coatings: [MediaCoating!]
  """Paper grain direction"""
  grainDirection: MediaGrainDirection
  """Which sides of the media can be printed"""
  imageableSide: MediaImageableSide
  """Transparency level of the media"""
  opacity: MediaOpacity
  """Printing technology compatibility"""
  printingTechnology: MediaPrintingTechnology
  """Paper stock type classification"""
  stockType: MediaStockType
  """Surface texture or finish"""
  texture: MediaTexture
  """Base color of the media"""
  color: MediaColor
  """Factory-applied coatings already on the media"""
  preAppliedCoatings: [MediaCoating!]
  """Shrink compensation factors [x, y] as percentages"""
  shrinkIndex: [Float!]
  """ISO brightness percentage (0–100)"""
  brightness: Float
  """CIE whiteness index"""
  cieWhiteness: Float
  """Paper grade classification number"""
  grade: Int
  """Corrugated board flute type per JDF specification"""
  fluteType: MediaFluteType
  """Percentage of recycled content (0–100)"""
  recycledPercentage: Float
  """Whether this substrate is supplied by the buyer"""
  buyerSupplied: Boolean
  """Moisture content percentage (0–100)"""
  moisture: Float
  """Supplier lead time in calendar days"""
  supplierLeadTimeDays: Int
  """Whether this substrate is available for use"""
  isActive: Boolean
  """Minimum stock level before reorder is triggered"""
  reorderThreshold: Float
  """Unit of measure for the reorder threshold"""
  reorderUnit: MeasurementUnit
  """Cost per unit in the specified currency"""
  unitCost: Float
  """Currency code for unitCost"""
  costCurrency: CurrencyISO
  """Free-text notes"""
  notes: String
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.