← All types
PrepressIn Input object

UpsertFileInput

Input for creating or updating an external-backed file. Cloud-backed files go through requestFileUploads / completeFileUploads.

Fields

id

FileIDOptional

ID for update; omit for create

jobId

JobIDOptional

Associated job ID

Associated component ID

Associated order ID

Associated estimate ID

Associated invoice ID

Associated purchase order ID

name

String!Required

Display name (required)

Original filename (required)

MIME type (required)

sizeBytes

IntOptional

File size in bytes, if known. Must be greater than 0 when given

Storage key for external-backed files. Required on create; cannot be set on cloud-backed files.

File checksum

File category (required)

Possible values (11)
ARTWORK

Artwork file

PREPRESS

Prepress file

IMPOSITION

Imposition file

PROOF

Proof file

PRODUCTION_OUTPUT

Production output file

QUALITY_REPORT

Quality report file

INVOICE

Invoice file

DELIVERY_NOTE

Delivery note file

PURCHASE_ORDER

Purchase order file

SUBSTRATE

Substrate-related file

OTHER

Other file category

Processing status (defaults to ready for external creates)

Possible values (5)
UPLOADING

File is being uploaded

PROCESSING

File is being processed

READY

File is ready for use

FAILED

File processing failed

ARCHIVED

File is archived

Usage role when attached to a component

Possible values (5)
ARTWORK

Artwork usage

TEMPLATE

Template usage

DATA

Data usage

PATH

Path usage

OTHER

Other usage

Parent file ID for versioned files

Version number (defaults to 1)

Processing metadata (JSON)

ID of the user uploading the file

Referenced by (1)
Exact type SDL
"""
Input for creating or updating an external-backed file. Cloud-backed files go through requestFileUploads / completeFileUploads.
"""
input UpsertFileInput {
  """ID for update; omit for create"""
  id: FileID
  """Associated job ID"""
  jobId: JobID
  """Associated component ID"""
  componentId: ComponentID
  """Associated order ID"""
  orderId: OrderID
  """Associated estimate ID"""
  estimateId: EstimateID
  """Associated invoice ID"""
  invoiceId: InvoiceID
  """Associated purchase order ID"""
  purchaseOrderId: PurchaseOrderID
  """Display name (required)"""
  name: String!
  """Original filename (required)"""
  originalFilename: String!
  """MIME type (required)"""
  mimeType: String!
  """File size in bytes, if known. Must be greater than 0 when given"""
  sizeBytes: Int
  """
  Storage key for external-backed files. Required on create; cannot be set on cloud-backed files.
  """
  externalStorageKey: String
  """File checksum"""
  checksum: String
  """File category (required)"""
  category: FileCategory!
  """Processing status (defaults to ready for external creates)"""
  status: FileStatus
  """Usage role when attached to a component"""
  usageRole: ComponentFileUsageRole
  """Parent file ID for versioned files"""
  parentFileId: FileID
  """Version number (defaults to 1)"""
  versionNumber: Int
  """Processing metadata (JSON)"""
  processingMetadata: JSONMap
  """ID of the user uploading the file"""
  uploadedByUserId: UserID
}