Production
Jobs
Explore the data types and operations available in Jobs.
250 operations
Accept an estimate and create order + jobs with components/operations from production blueprints. Requires order:write.
acceptProductionMutationAccept physical production once, with optional warehousing. Authorizes each retry and never infers inventory from observation counts.
addJobToJobGroupMutationAdd a new job to a group by instantiating the group's template. Requires jobGroup:write permission.
aggregateComponentsQueryAggregate components with optional filtering. Returns count, sum, avg, min, max. Requires component:list permission.
aggregateJobsQueryAggregate jobs with optional filtering. Returns count, sum, avg, min, max. Requires job:list permission.
aggregateOperationsQueryAggregate operations with optional filtering. Returns count, sum, avg, min, max. Requires operation:list permission.
assessOperationInputsQueryCompare retained input facts and optionally inspect attributed stock. Read-only; no technical feasibility or execution readiness guarantee. Stock checking additionally requires warehouseStock:read.
auditProductionQueryAudit in-flight production for a job: evaluate current progress against the production DAG to detect waste, yield shortfalls, duration overruns, and item-level failures with downstream cascade analysis. Requires job:read permission.
auditProductionEnrichedQueryEnriched production audit: same as auditProduction but additionally includes work center baseline metrics, production cell rankings, and live in-flight performance from LightTS progress hourly aggregates. Returns the same AuditVerdictOutput type with enrichments and livePerformance fields populated.
cancelMilestoneMutationMark a milestone as cancelled, optionally recording a reason. Requires milestone:write permission.
cancelScenarioSimulationMutationCancel a queued or running simulation. The run ends CANCELLED; a run already in a terminal status is left unchanged and reported as a field error. Requires scenarioSimulationRun:execute.
cancelScheduleOptimizationMutationCancel a running schedule optimization. The run transitions to CANCELLED status.
cancelTaskMutationCancel a task. Requires task:transition permission, and the caller must be the assignee, the claimer, a member of the assigned team while unclaimed, or a task:write holder.
claimTaskMutationClaim a team-assigned task. Requires task:claim permission.
cleanupProductionActualsMutationManually reclaim optional source details or closed production report chains. Tenant-scoped, bounded and preview-first; execution may partially succeed across entries. Receipts, acceptance, inventory, costs and completions are retained.
compileSchemaXMLQueryCompile standalone XML schema syntax into JSON Schema without persisting it; host restrictions apply when embedded.
completeMilestoneMutationMark a milestone as completed. Requires milestone:write permission.
completeMyTaskMutationComplete an open personal to-do directly, whatever the status order. Its owner or a task:write holder.
completeTaskFromJourneyMutationComplete a journey task with the result of the journey the caller ran. The result is checked against the journey's declared outputs; the journey's own steps already ran as the caller. Requires task:transition, and the caller must be the assignee, the claimer, a member of the assigned team while unclaimed, or a task:write holder. Repeating it with the same result returns the completed task.
configureWorkCenterTwinMutationReplaces a work centre's twin settings. This is the only route to them: the work centre's own create and update do not accept them. Requires workCenterBehaviorProfile:write permission.
correctProductionOutputMutationRecord an immutable correction and, when warehoused, reduce only untouched original holdings. Never reverse consumed inputs or downstream-used products.
correctWorkCenterStatusEventMutationVoid or supersede a status event atomically. Preserves original history and records the authenticated actor. Requires workCenter:write permission.
createBatchMutationCreate a batch; validates tenant, scope and references
createBatchComponentMutationCreate a batchComponent; validates tenant, scope and references
createBatchContributionMutationCreate a batchContribution; validates tenant, scope and references
createCapabilityMutationCreate a new capability. Requires capability:write permission.
createComponentMutationCreate a new component. Requires component:write permission.
createComponentGroupMutationCreate a new component section. Requires componentGroup:write permission.
createEntityNoteMutationSave note changes independently of embedding success
createJobMutationCreate a new job. Requires job:write permission.
createJobGroupMutationCreate a new job group. Requires jobGroup:write permission.
createJobsFromOrderMutationCreate jobs from order lines. Requires job:write.
createMilestoneMutationCreate a new milestone. Requires milestone:write permission.
createMyTaskMutationCreate a personal to-do assigned to the caller (MANUAL, ALLOCATED). Any signed-in user; no permission needed.
createOperationMutationCreate a new operation. Requires operation:write permission.
createOperationEdgeMutationCreate a single operation dependency edge. Requires operation:write permission.
createOperationItemMutationCreate a new operation item. Requires operation:write permission.
createOperationItemEdgeMutationCreate a single item-level dependency edge. Requires operation:write permission.
createProductionCellMutationCreate a new production cell. Requires productionCell:write permission.
createProductionPlanMutationCreate a new production plan. Requires productionPlan:write permission.
createProductionReportMutationCreate a production report and any consumption rows. Requires productionReport:write.
createScheduleAllocationMutationCreate a new schedule allocation. Requires scheduleScenario:write permission.
createScheduleScenarioMutationCreate a new schedule scenario. Requires scheduleScenario:write permission.
createShiftDefinitionMutationCreate a new shift definition in the caller's tenant; the server mints its "shd" TypeID and timestamps. Validation failures come back as payload errors rather than as a GraphQL error. Requires shiftDefinition:write permission.
createTaskMutationCreate a new task. Requires task:write permission.
createWorkCenterMutationCreate a new work center. Requires workCenter:write permission.
createWorkCenterCapabilityMutationAssigns a capability to a work center with a server-generated id. Nothing is persisted if a constraint URI fails validation; the errors are returned instead. Requires workCenter:write permission.
createWorkCenterDeviceMutationCreate a new work center ↔ device binding. Requires workCenter:write.
createWorkCenterShiftProfileMutationCreates a new work center shift profile with a server-generated id. Requires workCenter:write.
dataChangeEventsSubscriptionSubscribe to real-time data change events. Requires read permission on each requested resource. Task topics are the exception: a signed-in user without task:read receives the events of their own tasks only (assigned to them, claimed by them, unclaimed on their teams).