Production
Jobs
Explore the data types and operations available in Jobs.
250 operations
Delete a batch; validates tenant, scope and references
deleteBatchComponentMutationDelete a batchComponent; validates tenant, scope and references
deleteBatchContributionMutationDelete a batchContribution; validates tenant, scope and references
deleteCapabilityMutationDelete a capability owned by the caller's tenant. Non-tenant-scoped capabilities cannot be deleted: the payload reports success: false instead. Requires capability:delete permission.
deleteComponentMutationDelete a component. Requires component:delete permission.
deleteComponentGroupMutationDelete a component section. Requires componentGroup:delete permission.
deleteEntityNoteMutationSave note changes independently of embedding success
deleteJobMutationDelete a job. Requires job:delete permission.
deleteMilestoneMutationDelete a milestone. Requires milestone:delete permission.
deleteOperationMutationDelete an operation. Requires operation:delete permission.
deleteOperationItemMutationDelete an operation item. Requires operation:delete permission.
deleteProductionCellMutationDelete a production cell. Work centers in the cell are kept but become ungrouped, and schedule scenarios targeting it lose that target. Requires productionCell:delete permission.
deleteScheduleAllocationMutationDelete a schedule allocation from its scenario. Returns success: false with an "id" error when no such allocation exists. Requires scheduleScenario:write permission.
deleteScheduleScenarioMutationPermanently delete a schedule scenario. Requires scheduleScenario:delete permission.
deleteShiftDefinitionMutationDelete a shift definition from the caller's tenant. Deleting one that does not exist is reported as success: false with an "id" error, not as a GraphQL error. Requires shiftDefinition:delete permission.
deleteTaskMutationDelete a task. Requires task:delete permission. A task with logged time, voided entries included, is refused with code TASK_HAS_LOGGED_TIME: cancel it instead.
deleteWorkCenterMutationPermanently delete a work center from the caller's tenant. Returns success = false when no work center with that id exists. Prefer setting lifecycle = ARCHIVED to retire a work center that has production history. Requires workCenter:delete permission.
deleteWorkCenterCapabilityMutationRemoves a capability assignment from a work center. Returns success: false with an "id" error when the assignment does not exist in the caller's tenant. Requires workCenter:write permission.
deleteWorkCenterDeviceMutationRemove a work center ↔ device binding. Requires workCenter:write.
deleteWorkCenterShiftProfileMutationPermanently deletes a work center shift profile, so the work center no longer runs that shift definition over the profile's window. Requires workCenter:write.
destroyJobGroupMutationDelete a job group (jobs are unlinked, not deleted). Requires jobGroup:delete permission.
destroyJobGroupAndJobsMutationDelete a job group and all its jobs. Requires jobGroup:delete permission.
discardTaskTimerMutationDiscard the caller's running timer on a task: it is voided with no duration and stays on record. Only the timer's owner.
entityNotesQueryRead operational notes with current target permissions
evaluateProducibilityQueryEvaluate whether a component can be produced by the given work centers
fulfilDelegatedWorkMutationComplete delegated job work from finished producer evidence without duplicate machine metrics or production receipts.
generateDefaultDataQueryQueryGenerate a default GraphQL data query for an event topic. Returns a query string with all scalar fields for the resource, or null if the topic has no matching query. The query uses $id as the variable for the resource ID.
getBatchQueryFetch one batch; tenant scoped
getBatchComponentQueryFetch one batchComponent; tenant scoped
getBatchContributionQueryFetch one batchContribution; tenant scoped
getCapabilityQueryFetch a single capability by id, scoped to the caller's tenant. Null when no visible capability has that id. Requires capability:read permission.
getCapabilityByCodeQueryResolve an existing capability by code. A tenant-owned definition takes precedence over a shared definition, matching inference. Ambiguous definitions fail; missing codes return null. Read-only; requires capability:read.
getComponentQueryFetch a component by ID. Requires component:read permission.
getComponentByQueryFetch a component by external ID. Requires component:read permission.
getComponentGroupQueryFetch a component section by ID. Requires componentGroup:read permission.
getEntityNoteQueryRead operational notes with current target permissions
getEntityNoteBySourceQueryRead operational notes with current target permissions
getExistingCapabilityQueryRead an existing capability reference by identity. Returns null if not visible. Requires capability:read.
getJobQueryFetch a job by ID. Requires job:read permission.
getJobByQueryFetch a job by external ID. Requires job:read permission.
getJobGroupQueryFetch a job group by ID. Requires jobGroup:read permission.
getMagicQueryGraphQLQueryResolves a Magic Query string to the real GraphQL operation and variables it runs, so consumers can graduate from the façade to raw GraphQL. Does not execute.
getMagicQuerySchemaQueryReturns the input JSON Schema and output introspection for a Magic Query noun, so consumers (especially LLMs) can learn its contract before calling magicQuery.
getMilestoneQueryFetch a milestone by ID. Requires milestone:read permission.
getMilestoneByQueryFetch a milestone by any of its external ids. Every supplied id must match; with none, returns null. Requires milestone:read permission.
getOperationQueryFetch an operation by ID. Requires operation:read permission.
getOperationByQueryFetch an operation by external ID. Requires operation:read permission.
getOperationCompletionQueryFetch an operation completion record by ID. Requires operation:read permission.
getOperationCompletionByOperationQueryFetch the most recent completion record for an operation. Requires operation:read permission.
getOperationParameterSchemaQueryReturns the JSON Schema (draft-07) for the parameters field of the given operation kind, or null if no schema is defined for that kind. Use this to drive dynamic form generation on the client. Requires operation:read permission.