UpsertFileInput

"""
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 (required)"""
  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
}