# Production Floor Jobs, components, operations, scheduling, production reporting, and the files attached to them. ## Operations ```graphql # Production Floor (production-floor) # Jobs, components, operations, scheduling, production reporting, and the files attached to them. # The largest view. Start from listJobs or productionBoard. # Query aggregateComponents: ComponentAggregate! # Aggregate components with optional filtering aggregateJobs: JobAggregate! # Aggregate jobs with optional filtering aggregateOperations: OperationAggregate! # Aggregate operations with optional filtering auditProduction: AuditVerdictOutput! # Audit 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 auditProductionEnriched: AuditVerdictOutput! # Enriched 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 compileSchemaXML: String! # Compile standalone XML schema syntax into JSON Schema without persisting it; host restrictions apply when embedded entityNotes: EntityNotePage! # Read operational notes with current target permissions evaluateProducibility: ProducibilityResultOutput! # Evaluate whether a component can be produced by the given work centers folder: Folder # A single folder in the caller's tenant, or null when no folder with that id exists there folders: FolderConnection! # Folders in the caller's tenant, filtered and sorted, as a connection generateDefaultDataQuery: String # Generate a default GraphQL data query for an event topic getCapability: CapabilityState # Fetch a single capability by id, scoped to the caller's tenant getCapabilityByCode: ExistingCapability # Resolve an existing capability by code getComponent: ComponentState # Fetch a component by ID getComponentBy: ComponentState # Fetch a component by external ID getComponentGroup: ComponentGroupState # Fetch a component section by ID getDropboxBackend: DropboxBackend # Fetch one storage backend as a Dropbox backend getEntityNote: EntityNote # Read operational notes with current target permissions getEntityNoteBySource: EntityNote # Read operational notes with current target permissions getExistingCapability: ExistingCapability # Read an existing capability reference by identity getFTPBackend: FTPBackend # Fetch one storage backend as an FTP backend getFile: FileState # Fetch a file by ID getGoogleDriveBackend: GoogleDriveBackend # Fetch one storage backend as a Google Drive backend getHostPathBackend: HostPathBackend # Fetch one storage backend as a host-path backend getJob: JobState # Fetch a job by ID getJobBy: JobState # Fetch a job by external ID getJobGroup: JobGroupState # Fetch a job group by ID getMagicQueryGraphQL: MagicQueryOperation! # Resolves a Magic Query string to the real GraphQL operation and variables it runs, so consumers can graduate from the façade to raw GraphQL getMagicQuerySchema: MagicQuerySchema! # Returns the input JSON Schema and output introspection for a Magic Query noun, so consumers (especially LLMs) can learn its contract before calling magicQuery getMilestone: MilestoneState # Fetch a milestone by ID getMilestoneBy: MilestoneState # Fetch a milestone by any of its external ids getOperation: OperationState # Fetch an operation by ID getOperationBy: OperationState # Fetch an operation by external ID getOperationCompletion: OperationCompletionState # Fetch an operation completion record by ID getOperationCompletionByOperation: OperationCompletionState # Fetch the most recent completion record for an operation getOperationParameterSchema: JSON # Returns the JSON Schema (draft-07) for the parameters field of the given operation kind, or null if no schema is defined for that kind getOptimizationRun: OptimizationRunState # Get an optimization run by ID getProductionCell: ProductionCellState # Fetch a single production cell by id, scoped to the caller's tenant getProductionPlan: ProductionPlanWithChildren # A single production plan with all of its planned operations and edges getProductionReport: ProductionReportState # Fetch a production report by ID getS3Backend: S3Backend # Fetch one storage backend as an S3 backend getScheduleScenario: ScheduleScenarioState # Fetch a single schedule scenario by id, or null when it does not exist getShiftDefinition: ShiftDefinitionState # Fetch a single shift definition by id, or null when no definition with that id exists in the caller's tenant getStorageBackend: StorageBackendOutput # Fetch one storage backend by id getTask: TaskState # Fetch a task by ID getTaskEvents: TaskEventConnection! # Fetch the audit trail for a task, paginated getWorkCenter: WorkCenterState # Fetch a single work center by id, scoped to the caller's tenant getWorkCenterBy: WorkCenterState # Fetch a work center by external ID getWorkCenterCapability: WorkCenterCapabilityState # One capability assignment by its own id, or null when it is not in the caller's tenant getWorkCenterDevice: WorkCenterDeviceState # One device binding by its own id, or null when it is not in the caller's tenant getWorkCenterShiftProfile: WorkCenterShiftProfileState # One shift profile assignment by its own id, or null when it is not in the caller's tenant helpChapter: HelpChapter # Read a chapter of the current published manual edition helpChapters: [HelpChapterInfo!]! # List human-facing manual chapters from the running deployment iacGuides: [IaCGuide!]! # Every authoring guide, for a tool that syncs them to a folder iacSchema: IaCSchemaDocument! # The infrastructure-only view of this schema, for declarative tooling iacSchemaDocument: IaCSchemaDocumentPayload! # Fetch the JSON Schema document a SCHEMA-kind validator references, for declarative tooling iacValidate: IaCValidationResult! # Validate an infrastructure artifact jobCostingSummary: JobCostingSummaryPayload! # Get a costing summary for a job including material and operation costs listCapabilities: CapabilityConnection! # List the capabilities visible to the caller's tenant — the tenant's own capabilities plus any non-tenant-scoped ones listComponentGroups: ComponentGroupConnection! # List component sections, optionally scoped to a job listComponents: ComponentConnection! # List components with pagination and filtering listDataChangeEventTopics: [DataChangeEventGroup!]! # List all valid data change event topics, grouped by resource listFiles: FileConnection! # List files with pagination and filtering listJobGroups: JobGroupConnection! # List job groups with pagination listJobs: JobConnection! # List jobs with pagination and filtering listMagicQueries: [MagicQueryInfo!]! # Lists every available Magic Query noun with a short description and its options — the discovery entry point listMilestones: MilestoneConnection! # List milestones with pagination and filtering listOperationCompletions: OperationCompletionConnection! # List operation completion records with pagination listOperationEdges: OperationEdgeConnection! # List every operation dependency edge of a job, ordered by `sortOrder` ascending, with pagination listOperationItemEdges: OperationItemEdgeConnection! # List item-level dependency edges, with pagination listOperationItems: OperationItemConnection! # List operation items for an operation, sorted by sortOrder, with pagination listOperations: OperationConnection! # List operations with pagination and filtering listOptimizationRuns: OptimizationRunConnection! # List optimization runs for a scenario, paginated listProductionCells: ProductionCellConnection! # List the tenant's production cells as a paginated connection, with optional filtering and sorting listProductionPlans: ProductionPlanConnection! # Production plans of a job, newest version first, paginated listProductionReports: ProductionReportConnection! # List production reports for the tenant, paginated listScheduleAllocations: ScheduleAllocationConnection! # List the allocations of one schedule scenario, ordered by start time by default listScheduleScenarios: ScheduleScenarioConnection! # List the caller's tenant's schedule scenarios as a keyset-paginated connection listShiftDefinitions: ShiftDefinitionConnection! # List the current tenant's shift definitions as a connection listStorageBackends: StorageBackendConnection! # List the calling tenant's storage backends listTasks: TaskConnection! # List all tasks with pagination listWorkCenterCapabilities: WorkCenterCapabilityConnection! # All capability assignments for one work center in the caller's tenant, returned in a single unpaginated page listWorkCenterDevices: WorkCenterDeviceConnection! # List the controller devices bound to a work center, preferred first listWorkCenterShiftProfiles: WorkCenterShiftProfileConnection! # Lists the shift profiles of one work center within the caller's tenant, ordered by validFrom ascending listWorkCenterStatusEvents: WorkCenterStatusEventConnection! # List status transition events for a work center listWorkCenters: WorkCenterConnection! # List the tenant's work centers as a paginated connection, with optional filtering and sorting magicQuery: JSON! # Executes a Magic Query string and returns the predefined query's JSON result myTasks: TaskConnection! # List tasks assigned to the current user or their teams ping: String! # Health check endpoint previewPlannedOperationAudit: PlannedOperationAuditPreview! # Preview waste, yield, duration and constant-rate pace for a stored planned operation producibilityIntelligence: ProducibilityIntelligenceOutput! # Combined producibility intelligence: rule-based feasibility, ML predictions, risk analysis, and similar historical jobs in a single query productionBoard: ProductionBoardPayload! # Fetch active production jobs with components, operations, and order context productionDay: ProductionDay! # Status history, published plan and shifts for up to 100 active work centers of one cell over a window of at most 36 hours productionSnapshot: ProductionSnapshot! # Read production resources with batched evidence projectWorkCenterTwin: WorkCenterTwinProjection! # Project one work centre over the next N hours: per-shift bands of expected busy and lost minutes, a down-probability strip and per-allocation ends, from the machine's behaviour profile and its published plan renderSchemaXML: String! # Render JSON Schema as native XML without dropping unsupported keywords or changing a saved document scenarioSimulationRun: ScenarioSimulationRun # A simulation run by id, or null when none exists scenarioSimulationRuns: ScenarioSimulationRunConnection! # Simulation runs, paginated schemaAuthoringCatalog: JSON! # Compiler-owned vocabulary for the standalone XML JSON Schema dialect, including native form annotations searchEntityNotes: EntityNoteSearchPage! # Read operational notes with current target permissions searchHelp: HelpSearchResult! # Search human-facing manuals using shared semantic and text retrieval simulateWorkload: SimulationResult! # Synchronous what-if over hypothetical work, optionally overlaid on a base scenario's allocations storageCapabilities: StorageCapabilitiesOutput! # Which storage backend kinds this deployment supports, so a client can hide unusable options twinBehaviorAttributes: [BehaviorAttributeDefinition!]! # The behaviour attributes the active vertical declares, highest priority first, so a custom app can render hypothetical inputs from the schema workCenterBehaviorProfile: WorkCenterBehaviorProfile # The latest behaviour profile version of a work centre, or null when none has been built workCenterBehaviorProfiles: WorkCenterBehaviorProfileConnection! # Behaviour profile versions, paginated workCenterTwinEvents: WorkCenterTwinEventConnection! # A work centre's twin transitions, newest first, of both tracks unless `track` narrows them workCenterTwinShadow: WorkCenterTwinShadow! # The live shadow of one work centre, computed now workCenterTwinShadows: WorkCenterTwinShadowConnection! # Work centres with a live shadow, newest transition first, each entry judged now; the filter applies to the state recorded by the latest transition, so an entry's live state may already differ # Mutation acceptEstimateAndCreateJobs: AcceptEstimatePayload! # Accept an estimate and create order + jobs with components/operations from production blueprints addJobToJobGroup: AddJobToJobGroupPayload! # Add a new job to a group by instantiating the group's template cancelMilestone: MilestonePayload! # Mark a milestone as cancelled, optionally recording a reason cancelScenarioSimulation: CancelScenarioSimulationPayload! # Cancel a queued or running simulation cancelScheduleOptimization: CancelOptimizationPayload! # Cancel a running schedule optimization cancelTask: TaskPayload! # Cancel a task claimTask: TaskPayload! # Claim a team-assigned task completeFileUploads: CompleteFileUploadsPayload! # Mark one or more uploads as ready completeMilestone: MilestonePayload! # Mark a milestone as completed configureWorkCenterTwin: ConfigureWorkCenterTwinPayload! # Replaces a work centre's twin settings correctWorkCenterStatusEvent: CorrectWorkCenterStatusEventPayload! # Void or supersede a status event atomically createCapability: UpsertCapabilityPayload! # Create a new capability createComponent: UpsertComponentPayload! # Create a new component createComponentGroup: UpsertComponentGroupPayload! # Create a new component section createEntityNote: EntityNotePayload! # Save note changes independently of embedding success createFile: UpsertFilePayload! # Create an external-backed file createFolder: FolderPayload! # Creates a folder in the caller's tenant createJob: UpsertJobPayload! # Create a new job createJobGroup: JobGroupPayload! # Create a new job group createJobsFromOrder: CreateJobsFromOrderPayload! # Create jobs from order lines createMilestone: MilestonePayload! # Create a new milestone createOperation: UpsertOperationPayload! # Create a new operation createOperationEdge: UpsertOperationGraphPayload! # Create a single operation dependency edge createOperationItem: UpsertOperationItemPayload! # Create a new operation item createOperationItemEdge: UpsertOperationItemEdgesPayload! # Create a single item-level dependency edge createProductionCell: UpsertProductionCellPayload! # Create a new production cell createProductionPlan: UpsertProductionPlanPayload! # Create a new production plan createProductionReport: CreateProductionReportPayload! # Create a production report and any consumption rows createScheduleAllocation: UpsertScheduleAllocationPayload! # Create a new schedule allocation createScheduleScenario: UpsertScheduleScenarioPayload! # Create a new schedule scenario createShiftDefinition: UpsertShiftDefinitionPayload! # Create a new shift definition in the caller's tenant; the server mints its "shd" TypeID and timestamps createStorageBackend: UpsertStorageBackendPayload! # Create a new storage backend createStorageBackendAuthorization: CreateStorageBackendAuthorizationPayload! # Start the OAuth consent flow for a Google Drive or Dropbox backend createTask: TaskPayload! # Create a new task createWorkCenter: UpsertWorkCenterPayload! # Create a new work center createWorkCenterCapability: UpsertWorkCenterCapabilityPayload! # Assigns a capability to a work center with a server-generated id createWorkCenterDevice: UpsertWorkCenterDevicePayload! # Create a new work center ↔ device binding createWorkCenterShiftProfile: UpsertWorkCenterShiftProfilePayload! # Creates a new work center shift profile with a server-generated id deleteCapability: DeleteCapabilityPayload! # Delete a capability owned by the caller's tenant deleteComponent: DeleteComponentPayload! # Delete a component deleteComponentGroup: DeleteComponentGroupPayload! # Delete a component section deleteEntityNote: DeletePayload! # Save note changes independently of embedding success deleteFile: DeletePayload! # Delete a file deleteFolder: DeletePayload! # Deletes a folder deleteJob: DeleteJobPayload! # Delete a job deleteMilestone: DeletePayload! # Delete a milestone deleteOperation: DeleteOperationPayload! # Delete an operation deleteOperationItem: DeletePayload! # Delete an operation item deleteProductionCell: DeleteProductionCellPayload! # Delete a production cell deleteScheduleAllocation: DeleteScheduleAllocationPayload! # Delete a schedule allocation from its scenario deleteScheduleScenario: DeleteScheduleScenarioPayload! # Permanently delete a schedule scenario deleteShiftDefinition: DeleteShiftDefinitionPayload! # Delete a shift definition from the caller's tenant deleteStorageBackend: DeletePayload! # Delete a storage backend deleteTask: DeletePayload! # Delete a task deleteWorkCenter: DeleteWorkCenterPayload! # Permanently delete a work center from the caller's tenant deleteWorkCenterCapability: DeleteWorkCenterCapabilityPayload! # Removes a capability assignment from a work center deleteWorkCenterDevice: DeleteWorkCenterDevicePayload! # Remove a work center ↔ device binding deleteWorkCenterShiftProfile: DeleteWorkCenterShiftProfilePayload! # Permanently deletes a work center shift profile, so the work center no longer runs that shift definition over the profile's window destroyJobGroup: DestroyJobGroupPayload! # Delete a job group (jobs are unlinked, not deleted) destroyJobGroupAndJobs: DestroyJobGroupPayload! # Delete a job group and all its jobs fileDownloadUrl: FileDownloadGrant! # Resolve a download URL inferOperations: ImposedOperationResultOutput! # Infer the required production operations for a component issueStockToProduction: IssueStockToProductionPayload! # Issue warehouse stock to production, creating transfers and reducing quantities lockScheduleScenario: LockScheduleScenarioPayload! # Freeze a schedule scenario by stamping lockedAt recordWorkCenterStatusEvent: RecordWorkCenterStatusEventPayload! # Record a work centre's status refreshWorkCenterBehaviorProfile: RefreshWorkCenterBehaviorProfilePayload! # Rebuild a work centre's behaviour profile from its history now, writing a new version reindexEntityNotes: EntityNoteReindexResult! # Queue bounded recoverable indexing work using the current model removeJobFromJobGroup: RemoveJobFromJobGroupPayload! # Remove a job from its group (job survives) requestFileUploads: RequestFileUploadsPayload! # Allocate one or more cloud upload URLs simulateScheduleScenario: SimulateScheduleScenarioPayload! # Queue a Monte-Carlo replay of a scenario's allocations against the work centres' learned behaviour profiles startMilestone: MilestonePayload! # Mark a milestone as started now startScheduleOptimization: StartOptimizationPayload! # Start a background schedule optimization testFolder: FolderProbeResult! # Checks a folder transport with a read-only stat probe testStorageBackend: StorageBackendProbeResult! # Probe a storage backend's connectivity with its stored credentials (a bucket/root head — nothing is written) transitionOperation: TransitionOperationPayload! # Transition operation to a new status transitionOperationItem: UpsertOperationItemPayload! # Transition operation item to a new status transitionTask: TaskPayload! # Transition a task's status uncancelMilestone: MilestonePayload! # Clear the cancellation state of a milestone uncompleteMilestone: MilestonePayload! # Mark a milestone as not completed unlockScheduleScenario: LockScheduleScenarioPayload! # Clear lockedAt so the scenario can be edited and published again unstartMilestone: MilestonePayload! # Clear a milestone's start updateCapability: UpsertCapabilityPayload! # Update a capability updateComponent: UpsertComponentPayload! # Update a component updateComponentGroup: UpsertComponentGroupPayload! # Update a component section updateEntityNote: EntityNotePayload! # Save note changes independently of embedding success updateFile: UpsertFilePayload! # Update a file updateFolder: FolderPayload! # Patches a folder updateJob: UpsertJobPayload! # Update a job updateMilestone: MilestonePayload! # Update a milestone updateOperation: UpsertOperationPayload! # Update an operation updateOperationEdge: UpsertOperationGraphPayload! # Update a single operation dependency edge updateOperationItem: UpsertOperationItemPayload! # Update an operation item updateOperationItemEdge: UpsertOperationItemEdgesPayload! # Patch a single item-level dependency edge updatePlannedOperationQuantities: PlannedOperationState! # Update only quantities on one planned step without replacing its identity, schedule allocations, durations or legacy productionQuantity updateProductionCell: UpsertProductionCellPayload! # Update a production cell updateProductionPlan: UpsertProductionPlanPayload! # Update a production plan updateScheduleAllocation: UpsertScheduleAllocationPayload! # Update a schedule allocation updateScheduleScenario: UpsertScheduleScenarioPayload! # Update a schedule scenario updateShiftDefinition: UpsertShiftDefinitionPayload! # Patch an existing shift definition and stamp updatedAt updateStorageBackend: UpsertStorageBackendPayload! # Update a storage backend updateTask: TaskPayload! # Edit task metadata without changing its lifecycle updateWorkCenter: UpsertWorkCenterPayload! # Update a work center updateWorkCenterCapability: UpsertWorkCenterCapabilityPayload! # Patches an existing work center capability assignment and refreshes its updatedAt updateWorkCenterDevice: UpsertWorkCenterDevicePayload! # Update a work center ↔ device binding updateWorkCenterShiftProfile: UpsertWorkCenterShiftProfilePayload! # Partially updates an existing work center shift profile upsertCapability: UpsertCapabilityPayload! # Create a capability, or replace an existing one wholesale when input upsertComponent: UpsertComponentPayload! # Create or update a component upsertComponentGroup: UpsertComponentGroupPayload! # Create or update a component section upsertFile: UpsertFilePayload! # Create or update an external-backed file upsertJob: UpsertJobPayload! # Create or update a job upsertMilestone: MilestonePayload! # Create or update a milestone upsertOperation: UpsertOperationPayload! # Create or update an operation upsertOperationGraph: UpsertOperationGraphPayload! # Replace a job's entire operation dependency graph: all existing edges for the job are deleted and the supplied ones inserted, in a single transaction that also applies any operation scheduling preferences upsertOperationItem: UpsertOperationItemPayload! # Create or update a single operation item upsertOperationItemEdges: UpsertOperationItemEdgesPayload! # Batch upsert item-level dependency edges upsertOperationItems: UpsertOperationItemsPayload! # Batch upsert operation items for an operation (replaces all existing items) upsertProductionCell: UpsertProductionCellPayload! # Create a production cell, or fully overwrite an existing one when input upsertProductionPlan: UpsertProductionPlanPayload! # Create or overwrite a production plan together with its full set of planned operations and edges, in one transaction upsertScheduleAllocation: UpsertScheduleAllocationPayload! # Create a schedule allocation, or overwrite an existing one when input upsertScheduleScenario: UpsertScheduleScenarioPayload! # Create a schedule scenario, or fully replace an existing one when input upsertShiftDefinition: UpsertShiftDefinitionPayload! # Create or overwrite a shift definition in one call upsertStorageBackend: UpsertStorageBackendPayload! # Create or update a storage backend in one call upsertWorkCenter: UpsertWorkCenterPayload! # Create a work center, or fully overwrite an existing one when input upsertWorkCenterCapability: UpsertWorkCenterCapabilityPayload! # Creates or wholly overwrites a work center capability assignment upsertWorkCenterDevice: UpsertWorkCenterDevicePayload! # Bind a controller device to a work center (or update its priority/active flag) upsertWorkCenterShiftProfile: UpsertWorkCenterShiftProfilePayload! # Creates a work center shift profile, or fully replaces an existing one when input # Subscription dataChangeEvents: DataChangeEvent! # Subscribe to real-time data change events scenarioSimulationProgress: SimulationProgressEvent! # Stream progress events for a simulation run scheduleOptimizationProgress: OptimizationProgressEvent! # Stream real-time progress events for a schedule optimization run statusEvents: StatusEvent! # Subscribe to committed status transitions workCenterTwinShadowChanged: WorkCenterTwinEvent! # Streams twin transitions as they are recorded — shadow transitions per operation and for the work centre as a whole, and pace-track transitions (STEADY, SLOWING, ENDED) — from the event bus — so a transition recorded by any node reaches the subscriber # Call describe_operation(name) for arguments and input types. ``` ## Exact schema Download [complete SDL](/schemas/production-floor.graphql) (605223 bytes). Use the SDL to validate operations; the digest omits argument signatures. ## Guides - [CRM — working with customers, contacts and addresses](/docs/data-model/erp#crm-working-with-customers-contacts-and-addresses) - [Estimates — prepare and revise an offer](/docs/data-model/erp#estimates-prepare-and-revise-an-offer) - [Orders — record what the customer is buying](/docs/data-model/erp#orders-record-what-the-customer-is-buying) - [From a sale to production](/docs/data-model/erp#from-a-sale-to-production) - [Start the printing job](/docs/data-model/production#start-the-printing-job) - [Find product templates and published versions](/docs/data-model/production#find-product-templates-and-published-versions) - [ERP API reference](/docs/data-model/erp-reference) - [Production API reference](/docs/data-model/production-reference) - [Product Template Authoring Guide](/docs/product-templates/authoring) - [Describe the parts to produce](/docs/data-model/production#describe-the-parts-to-produce) - [Plan the production steps](/docs/data-model/production#plan-the-production-steps) - [Schedule the work](/docs/data-model/production#schedule-the-work) - [Coordinate people and milestones](/docs/data-model/production#coordinate-people-and-milestones) - [Record progress on the shop floor](/docs/data-model/production#record-progress-on-the-shop-floor) - [Review production and costs](/docs/data-model/production#review-production-and-costs) - [Read the configured production resources](/docs/data-model/production#read-the-configured-production-resources)