← All resources

Resource

work_center

A work center (machine, person, tool, or location)

GraphQL reference →

Configuration

externalIdStringOptional

External system ID (must be unique per tenant)

productionCellIdProductionCellIDOptional

TypeID (prefix "pcl") of the production cell to place this work center in. Omit to leave it ungrouped.

References production_cell

costCenterIdCostCenterIDOptional

Associated cost center for rate lookup

References cost_center

nameString!Required

Work center name (required)

resourceTypeResourceType!Optional

Type of work center resource (defaults to machine)

Allowed values

MACHINE — Equipment that performs the work itself — a press, folder, cutter or similar. The default for a work centre created without a resource type.

HUMAN — A person rather than equipment; such a work centre normally carries linkedUserId pointing at the platform user it stands for.

TOOL — A reusable piece of tooling — a die, plate, jig or fixture — tracked as a bookable resource in its own right rather than as part of the machine that uses it.

LOCATION — A place rather than a worker or a machine — a bay, staging area or storage position — modelled as a work centre so that time on it can be booked.

linkedUserIdUserIDOptional

TypeID (prefix "usr") of the platform user this work center represents. Typically set for human resources.

References service_account

efficiencyFactorFloat!Optional

Efficiency factor (defaults to 1.0)

isActiveBoolean!Optional

Whether the work center is available for scheduling (defaults to true)

lifecycleWorkCenterLifecycle!Optional

Lifecycle: CONCEPT (planned or simulation only), ACTIVE (in the running plant) or ARCHIVED (retired, kept for history). Defaults to ACTIVE.

Allowed values

CONCEPT — Planned or experimental, for example a machine being evaluated in simulation. Not part of the running plant and not shown on the production board.

ACTIVE — Part of the running plant. The default.

ARCHIVED — Retired. Kept for history and reporting; not part of the running plant.

isMonitoredBoolean!Optional

Whether this work center is expected to report status. Set false for occasional manual stations or legacy machines so they never raise production attention. Defaults to true.

jmfDeviceIdStringOptional

Legacy JMF DeviceID alias for incoming signals. Print uses the canonical per-binding identifier set by setWorkCenterDeviceJMFDeviceID; aliases are not copied between bindings and work centers. Conflicting mappings to different work centers are not correlated.

defaultSetupMinutesInt!Optional

Average setup time in minutes before each operation. Cannot be negative; defaults to 0.

defaultProcessingRateFloatOptional

Processing rate in units per minute. Must be positive when set; omit to use each operation's expected duration instead.

defaultCleanupMinutesInt!Optional

Average cleanup time in minutes after each operation. Cannot be negative; defaults to 0.

defaultSetupWasteQuantityFloatOptional

Planned waste per makeready on this machine, in the operation's own unit. Finite and nonnegative; omit for none.

defaultRunWastePercentFloatOptional

Planned running waste as a percentage of net quantity, at least 0 and below 1000; omit for none.

twinWorkCenterTwin!Optional

The work centre's digital twin: its declared settings and the values the platform resolves from them. Written by configureWorkCenterTwin, never by the work centre's own update.

View WorkCenterTwin fields →

Input types

Fields for the structured values used in this resource’s configuration.

WorkCenterTwin

A work centre's digital twin as a read object: what is declared for it and what is in force. The live judgement is workCenterTwinShadow; the learned behaviour is workCenterBehaviorProfile

settingsWorkCenterTwinSettings!Required

The declared settings; written whole by configureWorkCenterTwin

View WorkCenterTwinSettings fields →

effectiveWorkCenterTwinEffectiveSettings!Required

The values the platform resolves from the settings and its defaults

View WorkCenterTwinEffectiveSettings fields →

WorkCenterTwinSettings

The twin settings an author declares for a work centre. Null means the server default; the resolved values are in WorkCenterTwin.effective

onTrackQuantileTwinQuantileOptional

Live shadow hysteresis bound: once DRIFTING, an operation returns to ON_TRACK only while elapsed time is at or below this quantile of the profile cell or its pace projection meets the plan. Null uses P50.

Allowed values

P05 — 5th percentile of the profile cell

P10 — 10th percentile of the profile cell

P25 — 25th percentile of the profile cell

P50 — Median of the profile cell

P75 — 75th percentile of the profile cell

P90 — 90th percentile of the profile cell

P95 — 95th percentile of the profile cell

driftingQuantileTwinQuantileOptional

Live shadow: elapsed time past this quantile is DRIFTING. Null uses P90. Never below onTrackQuantile.

Allowed values

P05 — 5th percentile of the profile cell

P10 — 10th percentile of the profile cell

P25 — 25th percentile of the profile cell

P50 — Median of the profile cell

P75 — 75th percentile of the profile cell

P90 — 90th percentile of the profile cell

P95 — 95th percentile of the profile cell

stallMinutesIntOptional

Live shadow: no progress point for this many minutes in SETUP or RUNNING is STALLED. Null uses the phase cell's P50, capped by the server's maximum.

downOverdueMinutesIntOptional

Live shadow: DOWN or ERROR for longer than this is DOWN_OVERDUE. Null uses the profile's mean time to repair × ln 10.

paceSlowingPercentIntOptional

Pace track: SLOWING once the forecast pace is this many percent slower than the machine's own history, STEADY again at half that. 1–100. Null uses 10.

WorkCenterTwinEffectiveSettings

The twin settings as resolved by the platform. The stall and overdue windows resolve per machine from its profile and are not reported here

onTrackQuantileTwinQuantile!Required

The on-track quantile in force

Allowed values

P05 — 5th percentile of the profile cell

P10 — 10th percentile of the profile cell

P25 — 25th percentile of the profile cell

P50 — Median of the profile cell

P75 — 75th percentile of the profile cell

P90 — 90th percentile of the profile cell

P95 — 95th percentile of the profile cell

driftingQuantileTwinQuantile!Required

The drifting quantile in force

Allowed values

P05 — 5th percentile of the profile cell

P10 — 10th percentile of the profile cell

P25 — 25th percentile of the profile cell

P50 — Median of the profile cell

P75 — 75th percentile of the profile cell

P90 — 90th percentile of the profile cell

P95 — 95th percentile of the profile cell

paceSlowingPercentInt!Required

The pace slowing percentage in force

Read-only values

Show values
idWorkCenterID!Read only

TypeID of the work center (prefix "wcr", e.g. "wcr_01K…").

computed by the platform

externalUrlStringRead only

External URL for the calling integration, or the primary identity for unscoped callers.

computed by the platform

externalIdentities[RecordExternalIdentity!]!Read only

All linked external identities, including identities belonging to other integrations.

computed by the platform

createdByIntegrationIdIntegrationInstanceIDRead only

Integration instance that originally created this record, when known.

References integration_instance

computed by the platform

createdByStackIdIaCStackIDRead only

IaC stack that originally created this record, when known.

computed by the platform

managedByStackIdIaCStackIDRead only

IaC stack currently managing this record's configuration and deletion.

computed by the platform

createdAtISO8601!Read only

ISO 8601 timestamp of when the work center was first created.

computed by the platform

updatedAtISO8601!Read only

ISO 8601 timestamp of the last mutation to this work center. Equal to createdAt until it is first updated.

computed by the platform

Lifecycle

The CLI can create this resource. The platform assigns its id.

When replacement is needed, the existing resource is removed before its replacement is created.