← API reference
CANONICAL TYPE REFERENCE

UpsertOperationInput

Input for creating or updating an operation

ID for update; omit for create

Parent job ID (required)

Associated component ID

Associated component group ID

Associated milestone ID

External system ID

nameString!

Operation name (required)

remarksString

Notes and remarks

Operation type (required)

Type of resource required

Preferred capability (id) for scheduling

Preferred work center for scheduling

Initial status (defaults to pending)

Production quantity

Expected duration in seconds

Deadline (ISO8601)

Scheduled start time (ISO8601)

Scheduled completion time (ISO8601)

Additional metadata as JSON object

Kind-specific production parameters (JSON). Use getOperationParameterSchema(kind:) to retrieve the expected schema before submitting.

Sort order (defaults to 0)

Supplier this operation is subcontracted to

Purchase order covering this outsourced operation

Expected lead time in calendar days

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.

Custom operation type name (when kind is custom)

View exact SDL
"""Input for creating or updating an operation"""
input UpsertOperationInput {
  """ID for update; omit for create"""
  id: OperationID
  """Parent job ID (required)"""
  jobId: JobID!
  """Associated component ID"""
  componentId: ComponentID
  """Associated component group ID"""
  componentGroupId: ComponentGroupID
  """Associated milestone ID"""
  milestoneId: MilestoneID
  """External system ID"""
  externalId: String
  """Operation name (required)"""
  name: String!
  """Notes and remarks"""
  remarks: String
  """Operation type (required)"""
  kind: OperationKind!
  """Type of resource required"""
  requiredResourceType: String
  """Preferred capability (id) for scheduling"""
  capabilityId: CapabilityID
  """Preferred work center for scheduling"""
  requestedWorkCenterId: WorkCenterID
  """Initial status (defaults to pending)"""
  status: OperationStatus
  """Production quantity"""
  productionQuantity: Int
  """Expected duration in seconds"""
  expectedDuration: Int
  """Deadline (ISO8601)"""
  deadline: ISO8601
  """Scheduled start time (ISO8601)"""
  scheduledStartAt: ISO8601
  """Scheduled completion time (ISO8601)"""
  scheduledCompletionAt: ISO8601
  """Additional metadata as JSON object"""
  metadata: JSONMap
  """
  Kind-specific production parameters (JSON). Use getOperationParameterSchema(kind:) to retrieve the expected schema before submitting.
  """
  parameters: JSON
  """Sort order (defaults to 0)"""
  sortOrder: Int
  """Supplier this operation is subcontracted to"""
  outsourcedSupplierId: SupplierID
  """Purchase order covering this outsourced operation"""
  outsourcedPurchaseOrderId: PurchaseOrderID
  """Expected lead time in calendar days"""
  outsourcedLeadTimeDays: 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
  """Custom operation type name (when kind is custom)"""
  customKind: String
}

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