← API reference
CANONICAL TYPE REFERENCE

OperationState

An operation within a job

Allocation captured at setup start; later schedule edits do not change execution evidence

Unique identifier

Parent job ID

Associated component ID

Associated component group ID

Associated milestone ID

External system ID

nameString!

Operation name

remarksString

Notes and remarks

Operation type

Type of resource required

Preferred capability (id) for scheduling

Preferred work center for scheduling

Current operation status

Production quantity

Expected duration in seconds

Deadline (ISO8601)

Scheduled start time (ISO8601)

Actual start time (ISO8601)

Scheduled completion time (ISO8601)

Actual completion time (ISO8601)

Additional metadata as JSON object

Kind-specific production parameters (JSON). Schema varies by kind — use getOperationParameterSchema to retrieve the JSON Schema for the target kind.

Sort order within the job

Supplier this operation is subcontracted to (nil = in-house)

Purchase order covering this outsourced operation

Expected lead time in calendar days for outsourced operations

Creation timestamp (ISO8601)

Last update timestamp (ISO8601)

Parent job. Requires job:read permission.

Parent component. Requires component:read permission.

Parent component group. Requires componentGroup:read permission.

Associated milestone. Requires milestone:read permission.

Requested work center. Requires workCenter:read permission.

Physical work units (items) within this operation. Requires operation:read permission.

Custom operation type name (when kind is custom)

View exact SDL
"""An operation within a job"""
type OperationState {
  """
  Allocation captured at setup start; later schedule edits do not change execution evidence
  """
  executionAllocation: OperationExecutionAllocation
  """Unique identifier"""
  id: OperationID!
  """Parent job ID"""
  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"""
  name: String!
  """Notes and remarks"""
  remarks: String
  """Operation type"""
  kind: OperationKind!
  """Type of resource required"""
  requiredResourceType: String
  """Preferred capability (id) for scheduling"""
  capabilityId: CapabilityID
  """Preferred work center for scheduling"""
  requestedWorkCenterId: WorkCenterID
  """Current operation status"""
  status: OperationStatus!
  """Production quantity"""
  productionQuantity: Int
  """Expected duration in seconds"""
  expectedDuration: Int
  """Deadline (ISO8601)"""
  deadline: ISO8601
  """Scheduled start time (ISO8601)"""
  scheduledStartAt: ISO8601
  """Actual start time (ISO8601)"""
  actualStartAt: ISO8601
  """Scheduled completion time (ISO8601)"""
  scheduledCompletionAt: ISO8601
  """Actual completion time (ISO8601)"""
  actualCompletionAt: ISO8601
  """Additional metadata as JSON object"""
  metadata: JSONMap
  """
  Kind-specific production parameters (JSON). Schema varies by kind — use getOperationParameterSchema to retrieve the JSON Schema for the target kind.
  """
  parameters: JSON
  """Sort order within the job"""
  sortOrder: Int!
  """Supplier this operation is subcontracted to (nil = in-house)"""
  outsourcedSupplierId: SupplierID
  """Purchase order covering this outsourced operation"""
  outsourcedPurchaseOrderId: PurchaseOrderID
  """Expected lead time in calendar days for outsourced operations"""
  outsourcedLeadTimeDays: Int
  """Creation timestamp (ISO8601)"""
  createdAt: ISO8601!
  """Last update timestamp (ISO8601)"""
  updatedAt: ISO8601!
  """Parent job. Requires job:read permission."""
  job: JobState
  """Parent component. Requires component:read permission."""
  component: ComponentState
  """Parent component group. Requires componentGroup:read permission."""
  componentGroup: ComponentGroupState
  """Associated milestone. Requires milestone:read permission."""
  milestone: MilestoneState
  """Requested work center. Requires workCenter:read permission."""
  requestedWorkCenter: WorkCenterState
  """
  Physical work units (items) within this operation. Requires operation:read permission.
  """
  items: [OperationItemState!]!
  """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.