Skip to content

Mutation ​

Type: Object

Fields ​

NameTypeArgsDescriptionDeprecated
acceptEstimateAndCreateJobsAcceptEstimatePayload!input: AcceptEstimateInput!Accept an estimate and create order + jobs with components/operations from production blueprints. Requires order:write.
addJobToJobGroupAddJobToJobGroupPayload!input: AddJobToJobGroupInput!Add a new job to a group by instantiating the group's template. Requires jobGroup:write permission.
attachCustomAppTeamAttachCustomAppTeamPayload!input: AttachCustomAppTeamInput!Attach a team to a custom app. Requires customappteam:write permission.
attachCustomAppUserAttachCustomAppUserPayload!input: AttachCustomAppUserInput!Attach a user to a custom app (enable kiosk mode for user). Requires customappuser:write permission.
bulkUpdateOrderStatusesBulkUpdateOrderStatusesPayload!input: BulkUpdateOrderStatusesInput!Update the status of multiple orders at once. Requires order:write.
calculateImpositionCalculateImpositionPayload!input: CalculateImpositionInput!Calculate imposition layout for a component and create ImpositionSpec records. Finished size, bleed, page count, and quantity are read from the component. Requires impositionSpec:write permission.
cancelExecutionCancelExecutionPayload!id: WorkflowExecutionID!Cancel a running workflow execution. Requires workflow:execute permission.
cancelMilestoneMilestonePayload!input: CancelMilestoneInput!Mark a milestone as cancelled, optionally recording a reason. Requires milestone:write permission.
cancelScheduleOptimizationCancelOptimizationPayload!id: OptimizationRunID!Cancel a running schedule optimization. The run transitions to CANCELLED status.
cancelTaskTaskPayload!id: TaskID!Cancel a task. Requires task:transition permission.
captureKnowledgeCaptureKnowledgePayload!input: CaptureKnowledgeInput!Capture a knowledge subgraph — concepts, a note, and instance/semantic edges — in one atomic transaction. The manual, deterministic core of knowledge capture; the Phase-2 LLM path produces this same input. scope is caller-controlled. Requires knowledgeNote:write permission.
claimTaskTaskPayload!id: TaskID!Claim a team-assigned task. Requires task:claim permission.
clearChatMessagesChatSessionPayload!sessionId: ChatSessionID!Clear all messages from a chat session. Requires chatsession:write permission.
clearIntegrationInstanceSecretIntegrationInstancePayload!id: IntegrationInstanceID!
key: String!
Remove a stored secret from an integration instance. Requires integrationInstance:write permission.
completeFileUploadsCompleteFileUploadsPayload!inputs: [CompleteFileUploadInput!]!Mark one or more uploads as ready. Requires file:write permission.
completeMilestoneMilestonePayload!input: CompleteMilestoneInput!Mark a milestone as completed. Requires milestone:write permission.
confirmKnowledgeNoteKnowledgeNotePayload!id: KnowledgeNoteID!Endorse a note: increments its confirmation count (raising its retrieval trust weight) and promotes a PENDING note to LIVE. Requires knowledgeNote:write permission.
consolidateImpositionFinishingConsolidateFinishingPayload!input: ConsolidateFinishingInput!Derive the consolidated per-kind finishing (cut-file) view from an imposed plan's per-cell finishing. Read-only. Provide either impositionSpecId or layoutJSON. Requires impositionSpec:execute permission.
convertEstimateToOrderConvertEstimateToOrderPayload!input: ConvertEstimateToOrderInput!Convert an accepted estimate into an order with order lines. Requires order:write.
createAddressUpsertAddressPayload!input: CreateAddressInput!Create a new address. Requires address:write permission.
createAIAdapterUpsertAIAdapterPayload!input: CreateAIAdapterInput!Create a new AI adapter. Requires aiadapter:write permission.
createAIAgentUpsertAIAgentPayload!input: CreateAIAgentInput!Create a new AI agent. Requires aiAgent:write permission.
createBusinessUnitUpsertBusinessUnitPayload!input: CreateBusinessUnitInput!Create a new business unit. Requires businessunit:write permission.
createCapabilityUpsertCapabilityPayload!input: CreateCapabilityInput!Create a new capability. Requires capability:write permission.
createCarrierUpsertCarrierPayload!input: CreateCarrierInput!Create a new carrier. Requires carrier:write permission.
createChatSessionChatSessionPayload!input: CreateChatSessionInput!Create a new chat session. Requires chatsession:write permission.
createComponentUpsertComponentPayload!input: CreateComponentInput!Create a new component. Requires component:write permission.
createComponentGroupUpsertComponentGroupPayload!input: CreateComponentGroupInput!Create a new component section. Requires componentGroup:write permission.
createConceptConceptPayload!input: CreateConceptInput!Manually author a concept in the ontology. Requires concept:write permission.
createContactUpsertContactPayload!input: CreateContactInput!Create a new contact. Requires contact:write permission.
createControllerUpsertControllerPayload!input: CreateControllerInput!Create a new controller. Requires controller:write permission.
createControllerPolicyUpsertControllerPolicyPayload!input: CreateControllerPolicyInput!Create a new controller policy. The referenced controller must exist in this tenant. Triggers a config.update push to the controller. Requires controller_policy:write permission.
createControllerTokenCreateControllerTokenPayload!input: CreateControllerTokenInput!Create a new controller token. Returns the signed token value. Requires controller_token:write permission.
createCostCategoryUpsertCostCategoryPayload!input: CreateCostCategoryInput!Create a new cost category, failing if the code is already taken. Requires costcategory:write permission.
createCostCenterUpsertCostCenterPayload!input: CreateCostCenterInput!Create a new cost center. Requires costcenter:write permission.
createCostRateUpsertCostRatePayload!input: CreateCostRateInput!Create a new cost rate (always version 1). Requires costrate:write permission.
createCustomAppUpsertCustomAppPayload!input: CreateCustomAppInput!Create a new custom app. Requires customapp:write permission.
createCustomAppSessionCustomAppSession!input: CreateCustomAppSessionInput!Create a session token for a custom app. The token should be passed in the X-App-Session header for RPC calls. Requires customapp:read permission.
createCustomAppVersionCreateCustomAppVersionPayload!input: CreateCustomAppVersionInput!Create a new version snapshot of a custom app. Requires customapp:write permission.
createCustomDataContainerUpsertCustomDataContainerPayload!input: CreateCustomDataContainerInput!Create a custom data container. Requires customapp:write permission.
createCustomerUpsertCustomerPayload!input: CreateCustomerInput!Create a new customer. Requires customer:write permission.
createCustomerPriceOverrideUpsertCustomerPriceOverridePayload!input: CreateCustomerPriceOverrideInput!Create a new customer price override. Requires customerPriceOverride:write permission.
createCustomWorkflowActionUpsertCustomWorkflowActionPayload!input: CreateCustomWorkflowActionInput!Create a new custom action. Requires customWorkflowAction:write permission.
createDashboardUpsertDashboardPayload!input: CreateDashboardInput!Create a new dashboard. Requires dashboard:write permission.
createDashboardCardUpsertDashboardCardPayload!input: CreateDashboardCardInput!Create a card on a dashboard. Only the dashboard owner may. Requires dashboard:write permission.
createDataClipUpsertDataClipPayload!input: CreateDataClipInput!Create a new data clip
createDataRecordUpsertDataRecordPayload!input: CreateDataRecordInput!Create a new data record. Requires datarecord:write permission.
createDataSchemaUpsertDataSchemaPayload!input: CreateDataSchemaInput!Create a new data schema. Requires dataschema:write permission.
createDeviceUpsertDevicePayload!input: CreateDeviceInput!Create a new device. Requires device:write permission.
createDeviceTokenCreateDeviceTokenPayload!input: CreateDeviceTokenInput!Create a new device token. Returns the signed token value. Requires device_token:write permission.
createEdgeAppUpsertEdgeAppPayload!input: CreateEdgeAppInput!Create a new DRAFT edge app row for input.handle. Rejects if a draft already exists for the handle (finish or delete it first). Drafts aren't pushed to controllers; use publishEdgeAppDraft to ship. Requires edge_app:write permission.
createEdgeAppInstallationUpsertEdgeAppInstallationPayload!input: CreateEdgeAppInstallationInput!Create a edgeApp installation. Validates the edgeApp exists in this tenant and isn't DRAFT, that the controller exists, that an optional bot user exists, and variables against the edgeApp's configSchema (when set); pushes config.update to the target controller. Requires edge_app_installation:write permission.
createEstimateUpsertEstimatePayload!input: CreateEstimateInput!Create a new estimate. Requires estimate:write permission.
createEstimateLineUpsertEstimateLinePayload!input: CreateEstimateLineInput!Create a new estimate line. Requires estimate:write permission.
createExternalSchemaUpsertExternalSchemaPayload!input: CreateExternalSchemaInput!Create a new external schema. Triggers background processing. Requires externalSchema:write permission.
createFileUpsertFilePayload!input: CreateFileInput!Create an external-backed file. Cloud-backed files use requestFileUploads. Requires file:write permission.
createFolderFolderPayload!input: CreateFolderInput!Creates a folder in the caller's tenant. The binding reference must resolve to a storage backend or controller owned by the tenant, the name must be unique within it, and at most one folder may be the tenant default. Requires folder:write permission.
createIncomingWebhookUpsertIncomingWebhookPayload!input: CreateIncomingWebhookInput!Create a new incoming webhook. Requires incomingWebhook:write permission.
createIntegrationDataContainerUpsertIntegrationDataContainerPayload!input: CreateIntegrationDataContainerInput!Create a new integration data container. Requires integrationDataContainer:write permission.
createIntegrationDefinitionIntegrationDefinitionPayload!input: CreateIntegrationDefinitionInput!Create a new integration definition. Requires integrationDefinition:write permission.
createIntegrationDraftIntegrationDefinitionPayload!input: CreateIntegrationDraftInput!Create a new integration draft. Requires integrationDefinition:write permission.
createIntegrationInstanceIntegrationInstancePayload!input: CreateIntegrationInstanceInput!Create a new integration instance. Requires integrationInstance:write permission.
createIntegrationSessionIntegrationSessionOutput!input: CreateIntegrationSessionInput!Create a session token for an integration instance. Requires integrationInstance:read permission.
createInvoiceUpsertInvoicePayload!input: CreateInvoiceInput!Create a new invoice. Requires invoice:write permission.
createInvoiceLineUpsertInvoiceLinePayload!input: CreateInvoiceLineInput!Create a new invoice line. Requires invoice:write permission.
createJobUpsertJobPayload!input: CreateJobInput!Create a new job. Requires job:write permission.
createJobGroupJobGroupPayload!input: CreateJobGroupInput!Create a new job group. Requires jobGroup:write permission.
createJobMaterialReservationUpsertJobMaterialReservationPayload!input: CreateJobMaterialReservationInput!Create a new job material reservation. Requires jobMaterialReservation:write permission.
createJobsFromOrderCreateJobsFromOrderPayload!input: CreateJobsFromOrderInput!Create jobs from order lines. Requires job:write.
createJourneyJourneyPayload!input: CreateJourneyInput!Create a new journey. PERSONAL is self-service; TEAM/INSTANCE require journey:write.
createJourneyVersionJourneyVersionPayload!input: CreateJourneyVersionInput!Create a new draft version of a journey. Always mints a new version rather than amending an open draft, so several drafts may be open at once. Owner for PERSONAL, else journey:write.
createKioskAppSessionCustomAppSession!input: CreateKioskAppSessionInput!Create a session for a kiosk app. No IAM required — validates via CustomAppUser binding.
createKnowledgeNoteKnowledgeNotePayload!input: CreateKnowledgeNoteInput!Contribute a knowledge note about a concept or an entity. Requires knowledgeNote:write permission.
createMetricUpsertMetricPayload!input: CreateMetricInput!Create a new metric. Requires metric:write permission.
createMilestoneMilestonePayload!input: CreateMilestoneInput!Create a new milestone. Requires milestone:write permission.
createMLModelConfigUpsertMLModelConfigPayload!input: CreateMLModelConfigInput!Create a new ML model config. Requires mlmodelconfig:write permission.
createNetworkUpsertNetworkPayload!input: CreateNetworkInput!Create a new network. Requires network:write permission.
createNotificationGroupUpsertNotificationGroupPayload!input: CreateNotificationGroupInput!Create a new notification group. Requires notificationGroup:write permission.
createNotificationRecipientUpsertNotificationRecipientPayload!input: CreateNotificationRecipientInput!Create a new notification recipient. Requires notificationRecipient:write permission.
createOperationUpsertOperationPayload!input: CreateOperationInput!Create a new operation. Requires operation:write permission.
createOperationCostMappingUpsertOperationCostMappingPayload!input: CreateOperationCostMappingInput!Create a new operation cost mapping. Requires costcategory:write permission.
createOperationEdgeUpsertOperationGraphPayload!input: CreateOperationEdgeInput!Create a single operation dependency edge. Requires operation:write permission.
createOperationItemUpsertOperationItemPayload!input: CreateOperationItemInput!Create a new operation item. Requires operation:write permission.
createOperationItemEdgeUpsertOperationItemEdgesPayload!input: CreateOperationItemEdgeInput!Create a single item-level dependency edge. Requires operation:write permission.
createOrderUpsertOrderPayload!input: CreateOrderInput!Create a new order. Requires order:write permission.
createOrderGraphCreateOrderGraphPayload!input: CreateOrderGraphInput!Create a complete order — header, customer, billing/shipping addresses, and lines — in a single transaction. Each nested input reuses the same type as the corresponding individual upsert mutation; nested ids are rejected because this mutation is create-only. The resolver also enforces customer:write / address:write / orderline:write when those nested inputs are provided.
createOrderLineUpsertOrderLinePayload!input: CreateOrderLineInput!Create a new order line. Requires order:write permission.
createPriceBracketUpsertPriceBracketPayload!input: CreatePriceBracketInput!Create a new price bracket. Requires priceBracket:write permission.
createProductUpsertProductPayload!input: CreateProductInput!Create a new product. Requires product:write permission.
createProductionCellUpsertProductionCellPayload!input: CreateProductionCellInput!Create a new production cell. Requires productionCell:write permission.
createProductionPlanUpsertProductionPlanPayload!input: CreateProductionPlanInput!Create a new production plan. Requires productionPlan:write permission.
createProductionReportCreateProductionReportPayload!input: CreateProductionReportInput!Create a production report and any consumption rows. Requires productionReport:write.
createProductTemplateUpsertProductTemplatePayload!input: CreateProductTemplateInput!Create a new product template. Requires productTemplate:write permission.
createProtobufSchemaUpsertProtobufSchemaPayload!input: CreateProtobufSchemaInput!Create a new protobuf schema. Requires protobufSchema:write permission.
createPurchaseOrderCreatePurchaseOrderPayload!input: CreatePurchaseOrderInput!Create a purchase order with lines, computing totals automatically. Requires purchaseOrder:write.
createPurchaseOrderLineUpsertPurchaseOrderLinePayload!input: CreatePurchaseOrderLineInput!Create a new purchase order line. Requires purchaseOrder:write permission.
createRecordedCostUpsertRecordedCostPayload!input: CreateRecordedCostInput!Create a new recorded cost. Requires recordedcost:write permission.
createScheduleAllocationUpsertScheduleAllocationPayload!input: CreateScheduleAllocationInput!Create a new schedule allocation. Requires scheduleScenario:write permission.
createScheduleScenarioUpsertScheduleScenarioPayload!input: CreateScheduleScenarioInput!Create a new schedule scenario. Requires scheduleScenario:write permission.
createScriptUpsertScriptPayload!input: CreateScriptInput!Create a new script. Requires script:write permission.
createShiftDefinitionUpsertShiftDefinitionPayload!input: CreateShiftDefinitionInput!Create 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.
createShipmentUpsertShipmentPayload!input: CreateShipmentInput!Create a new shipment. Requires shipment:write permission.
createShipmentItemUpsertShipmentItemPayload!input: CreateShipmentItemInput!Create a new shipment item. Requires shipment:write permission.
createShipmentPackageUpsertShipmentPackagePayload!input: CreateShipmentPackageInput!Create a new shipment package. Requires shipment:write permission.
createStorageBackendUpsertStorageBackendPayload!input: CreateStorageBackendInput!Create a new storage backend. Requires storageBackend:write permission.
createStorageBackendAuthorizationCreateStorageBackendAuthorizationPayload!input: CreateStorageBackendAuthorizationInput!Start the OAuth consent flow for a Google Drive or Dropbox backend. Persists a draft backend (status NEEDS_REAUTHORIZATION) and returns the provider consent URL to send the user to; the callback completes the draft. Requires storageBackend:write permission.
createSubstrateUpsertSubstratePayload!input: CreateSubstrateInput!Create a new substrate, failing if the code is already taken. Requires substrate:write permission.
createSubstrateTemplateLineUpsertSubstrateTemplateLinePayload!input: CreateSubstrateTemplateLineInput!Create a new substrate template line. Requires substrateTemplateLine:write permission.
createSupplierUpsertSupplierPayload!input: CreateSupplierInput!Create a new supplier. Requires supplier:write permission.
createTaskTaskPayload!input: CreateTaskInput!Create a new task. Requires task:write permission.
createTaxCodeUpsertTaxCodePayload!input: CreateTaxCodeInput!Create a new tax code. Requires taxCode:write permission.
createTemplateUpsertTemplatePayload!input: CreateTemplateInput!Create a new template. Requires template:write permission.
createWarehouseLocationWarehouseLocationPayload!input: CreateWarehouseLocationInput!Create a warehouse location in the caller's tenant and emit a created event. Returns validation errors instead of a location when the input is invalid. Requires warehouseLocation:write permission.
createWarehouseStockWarehouseStockPayload!input: CreateWarehouseStockInput!Create a warehouse stock record in the caller's tenant with a server-assigned WarehouseStock TypeID. Returns validation errors rather than a record when the quantities are invalid. Emits a warehouse-stock created event. Requires write access to warehouse stock.
createWarehouseTransferWarehouseTransferPayload!input: CreateWarehouseTransferInput!Create a warehouse transfer in the caller's tenant. Returns validation errors instead of saving when source and destination match or quantity is not positive. Requires warehouseTransfer:write permission.
createWorkCenterUpsertWorkCenterPayload!input: CreateWorkCenterInput!Create a new work center. Requires workCenter:write permission.
createWorkCenterCapabilityUpsertWorkCenterCapabilityPayload!input: CreateWorkCenterCapabilityInput!Assigns 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.
createWorkCenterDeviceUpsertWorkCenterDevicePayload!input: CreateWorkCenterDeviceInput!Create a new work center ↔ device binding. Requires workCenter:write.
createWorkCenterShiftProfileUpsertWorkCenterShiftProfilePayload!input: CreateWorkCenterShiftProfileInput!Creates a new work center shift profile with a server-generated id. Requires workCenter:write.
createWorkflowWorkflowPayload!input: CreateWorkflowInput!Create a new workflow. Requires workflow:write permission.
createWorkflowTriggerWorkflowTriggerPayload!input: CreateWorkflowTriggerInput!Create a new workflow trigger
createWorkflowVersionWorkflowVersionPayload!input: CreateWorkflowVersionInput!Create a new version of a workflow. Requires workflow:write permission.
createWorkspaceWorkspacePayload!input: CreateWorkspaceInput!Create a new workspace. PERSONAL is self-service; TEAM/INSTANCE require workspace:write.
createWorkspaceVersionWorkspaceVersionPayload!input: CreateWorkspaceVersionInput!Create a new draft version of a workspace. Always mints a new version rather than amending an open draft, so several drafts may be open at once. Owner for PERSONAL, else workspace:write.
deleteAddressDeleteAddressPayload!id: AddressID!Delete an address. Requires address:delete permission.
deleteAIAdapterDeletePayload!id: AIAdapterID!Delete an AI adapter. Requires aiadapter:delete permission.
deleteAIAgentDeletePayload!id: AIAgentID!Delete an AI agent. Requires aiAgent:delete permission.
deleteBusinessUnitDeletePayload!id: BusinessUnitID!Delete a business unit. Requires businessunit:delete permission.
deleteCapabilityDeleteCapabilityPayload!id: CapabilityID!Delete 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.
deleteCarrierDeletePayload!id: CarrierID!Delete a carrier. Requires carrier:delete permission.
deleteChatSessionDeletePayload!id: ChatSessionID!Delete a chat session. Requires chatsession:delete permission.
deleteComponentDeleteComponentPayload!input: DeleteComponentInput!Delete a component. Requires component:delete permission.
deleteComponentArtworkFileDeleteComponentArtworkFilePayload!input: DeleteComponentArtworkFileInput!Remove an artwork file reference from a component. Requires componentArtworkFile:delete permission.
deleteComponentGroupDeleteComponentGroupPayload!input: DeleteComponentGroupInput!Delete a component section. Requires componentGroup:delete permission.
deleteConceptDeletePayload!id: ConceptID!Delete a concept. Requires concept:delete permission.
deleteContactDeleteContactPayload!id: ContactID!Delete a contact. Requires contact:delete permission.
deleteControllerDeletePayload!id: ControllerID!Delete a controller. Requires controller:delete permission.
deleteControllerJMFConfigDeleteControllerJMFConfigPayload!controllerId: ControllerID!Remove a controller's JMF configuration. Requires controller:write.
deleteControllerPolicyDeletePayload!id: ControllerPolicyID!Delete a controller's policy. The controller falls back to default-deny on the next config.update push. Requires controller_policy:delete permission.
deleteCostCategoryDeletePayload!id: CostCategoryID!Delete a cost category. Requires costcategory:delete permission.
deleteCostCenterDeletePayload!id: CostCenterID!Delete a cost center. Requires costcenter:delete permission.
deleteCustomAppDeletePayload!id: CustomAppID!Delete a custom app. Requires customapp:delete permission.
deleteCustomAppVersionDeletePayload!id: CustomAppVersionID!Delete a custom app version. Requires customapp:delete permission.
deleteCustomDataContainerDeletePayload!input: DeleteCustomDataContainerInput!Delete a custom data container. Requires customapp:delete permission.
deleteCustomerDeletePayload!id: CustomerID!Delete a customer. Requires customer:delete permission.
deleteCustomerPriceOverrideDeletePayload!id: CustomerPriceOverrideID!Delete a customer price override. Requires customerPriceOverride:delete permission.
deleteCustomWorkflowActionDeletePayload!id: CustomWorkflowActionID!Permanently delete a custom action from the caller's tenant. Reports notFound when no such action exists. Requires customWorkflowAction:delete permission.
deleteDashboardDeletePayload!id: DashboardID!Delete a dashboard and all its cards. Requires dashboard:delete permission.
deleteDashboardCardDeleteDashboardCardPayload!cardId: DashboardCardID!
dashboardId: DashboardID!
Delete a card from a dashboard. Requires dashboard:write permission.
deleteDataClipDeletePayload!id: DataClipID!Delete a data clip
deleteDataRecordDeletePayload!input: DeleteDataRecordInput!Delete a data record. Requires datarecord:delete permission.
deleteDataSchemaDeletePayload!input: DeleteDataSchemaInput!Delete a data schema. Requires dataschema:delete permission.
deleteDeviceDeletePayload!id: DeviceID!Delete a device. Requires device:delete permission.
deleteEdgeAppDeletePayload!id: EdgeAppID!Delete a edge app row. Cascades to all installations pinning this row and pushes config.update to each affected controller. Use deprecateEdgeApp instead to retire a PUBLISHED row without losing installation history.
deleteEdgeAppInstallationDeletePayload!id: EdgeAppInstallationID!Delete a edgeApp installation. Triggers a config.update push to the controller.
deleteEstimateDeletePayload!id: EstimateID!Delete an estimate. Requires estimate:delete permission.
deleteEstimateLineDeletePayload!id: EstimateLineID!Delete an estimate line. Requires estimate:delete permission.
deleteExternalSchemaDeletePayload!id: ExternalSchemaID!Delete an external schema and all its entries. Requires externalSchema:delete permission.
deleteFileDeletePayload!id: FileID!Delete a file. Requires file:delete permission.
deleteFolderDeletePayload!id: FolderID!Deletes a folder. Refused for the tenant default folder and for any folder still referenced by files — the stored bytes would be orphaned. Requires folder:delete permission.
deleteImpositionSpecDeleteImpositionSpecPayload!input: DeleteImpositionSpecInput!Remove an imposition spec from a component. Requires impositionSpec:delete permission.
deleteIncomingWebhookDeletePayload!id: IncomingWebhookID!Delete an incoming webhook. Requires incomingWebhook:delete permission.
deleteIntegrationDataContainerDeletePayload!input: DeleteIntegrationDataContainerInput!Delete an integration data container. Requires integrationDataContainer:delete permission.
deleteIntegrationDefinitionDeletePayload!id: IntegrationDefinitionID!Delete an integration definition. Refuses while any instance is installed from it, rather than cascading — an instance reads its definition's manifest at execution time, so removing one underneath a live integration breaks it at the next fire rather than here. Requires integrationDefinition:delete permission.
deleteIntegrationInstanceDeletePayload!id: IntegrationInstanceID!Delete an integration instance. Requires integrationInstance:delete permission.
deleteInvoiceDeletePayload!id: InvoiceID!Delete an invoice. Requires invoice:delete permission.
deleteInvoiceLineDeletePayload!id: InvoiceLineID!Delete an invoice line. Requires invoice:delete permission.
deleteJobDeleteJobPayload!input: DeleteJobInput!Delete a job. Requires job:delete permission.
deleteJobMaterialReservationDeletePayload!id: JobMaterialReservationID!Delete a job material reservation. Requires jobMaterialReservation:delete permission.
deleteJourneyDeletePayload!id: JourneyID!Delete a journey and all its versions. Owner for PERSONAL, else journey:write.
deleteJourneyVersionDeletePayload!id: JourneyVersionID!Delete one version from a journey's authoring history. Fails when the version is the one the journey is currently published at — delete the journey itself to remove that. Owner for PERSONAL, else journey:write.
deleteKnowledgeNoteDeletePayload!id: KnowledgeNoteID!Delete a note and any graph edges it sourced. Requires knowledgeNote:delete permission.
deleteMetricDeletePayload!id: MetricID!Delete a metric and all its data points. Requires metric:delete permission.
deleteMilestoneDeletePayload!input: DeleteMilestoneInput!Delete a milestone. Requires milestone:delete permission.
deleteMLModelConfigDeletePayload!id: MLModelConfigID!Delete an ML model config. Requires mlmodelconfig:delete permission.
deleteNetworkDeletePayload!id: NetworkID!Delete a network. Requires network:delete permission.
deleteNotificationGroupDeletePayload!id: NotificationGroupID!Delete a notification group. Requires notificationGroup:delete permission.
deleteNotificationRecipientDeletePayload!id: NotificationRecipientID!Delete a notification recipient. Requires notificationRecipient:delete permission.
deleteOperationDeleteOperationPayload!input: DeleteOperationInput!Delete an operation. Requires operation:delete permission.
deleteOperationCostMappingDeletePayload!id: OperationCostMappingID!Delete an operation cost mapping. Requires costcategory:delete permission.
deleteOperationItemDeletePayload!input: DeleteOperationItemInput!Delete an operation item. Requires operation:delete permission.
deleteOrderDeletePayload!id: OrderID!Delete an order. Requires order:delete permission.
deleteOrderLineDeletePayload!id: OrderLineID!Delete an order line. Requires order:delete permission.
deletePaymentDeletePayload!id: PaymentID!Delete a payment record. Requires payment:delete permission.
deletePreflightReportDeletePreflightReportPayload!input: DeletePreflightReportInput!Delete a preflight report. Requires preflightReport:delete permission.
deletePrepressOperationDeletePrepressOperationPayload!input: DeletePrepressOperationInput!Delete a prepress operation. Requires prepressOperation:delete permission.
deletePriceBracketDeletePayload!id: PriceBracketID!Delete a price bracket. Requires priceBracket:delete permission.
deleteProductDeletePayload!id: ProductID!Delete a product. Requires product:delete permission.
deleteProductionCellDeleteProductionCellPayload!id: ProductionCellID!Delete 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.
deleteProductTemplateDeleteProductTemplatePayload!input: DeleteProductTemplateInput!Delete a product template. Requires productTemplate:delete permission.
deleteProtobufSchemaDeletePayload!input: DeleteProtobufSchemaInput!Delete a protobuf schema. Requires protobufSchema:delete permission.
deletePurchaseOrderDeletePayload!id: PurchaseOrderID!Delete a purchase order. Requires purchaseOrder:delete permission.
deletePurchaseOrderLineDeletePayload!id: PurchaseOrderLineID!Delete a purchase order line. Requires purchaseOrder:delete permission.
deleteRecordedCostDeletePayload!id: RecordedCostID!Delete a recorded cost. Requires recordedcost:delete permission.
deleteScheduleAllocationDeleteScheduleAllocationPayload!id: ScheduleAllocationID!Delete a schedule allocation from its scenario. Returns success: false with an "id" error when no such allocation exists. Requires scheduleScenario:write permission.
deleteScheduleScenarioDeleteScheduleScenarioPayload!id: ScheduleScenarioID!Permanently delete a schedule scenario. Requires scheduleScenario:delete permission.
deleteScriptDeletePayload!id: ScriptID!Delete a script. Requires script:delete permission.
deleteShiftDefinitionDeleteShiftDefinitionPayload!id: ShiftDefinitionID!Delete 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.
deleteShipmentDeletePayload!id: ShipmentID!Delete a shipment. Requires shipment:delete permission.
deleteShipmentItemDeletePayload!id: ShipmentItemID!Delete a shipment item. Requires shipment:delete permission.
deleteShipmentPackageDeletePayload!id: ShipmentPackageID!Delete a shipment package. Requires shipment:delete permission.
deleteStorageBackendDeletePayload!id: StorageBackendID!Delete a storage backend. Returns a notFound payload when no such backend exists in the caller's tenant. Also the way to clean up a draft left behind by an abandoned OAuth flow. Requires storageBackend:delete permission.
deleteSubstrateDeletePayload!id: SubstrateID!Delete a substrate. Requires substrate:delete permission.
deleteSubstrateTemplateLineDeletePayload!id: SubstrateTemplateLineID!Delete a substrate template line. Requires substrateTemplateLine:delete permission.
deleteSupplierDeletePayload!id: SupplierID!Delete a supplier. Requires supplier:delete permission.
deleteTaskDeletePayload!id: TaskID!Delete a task. Requires task:delete permission.
deleteTaxCodeDeletePayload!id: TaxCodeID!Delete a tax code. Requires taxCode:delete permission.
deleteTemplateDeleteTemplatePayload!id: TemplateID!Delete a template and all its versions. Requires template:delete permission.
deleteTemplateVersionDeletePayload!id: TemplateVersionID!Delete one version from a template's history. Fails when the version is the one the template is currently published at. Requires template:write permission.
deleteWarehouseLocationDeletePayload!id: WarehouseLocationID!Delete a warehouse location from the caller's tenant and emit a deleted event. Reports a not-found result when no such location exists. Requires warehouseLocation:delete permission.
deleteWarehouseStockDeletePayload!id: WarehouseStockID!Permanently delete a warehouse stock record from the caller's tenant. Reports not-found when no such record exists. Emits a warehouse-stock deleted event. Requires delete access to warehouse stock.
deleteWarehouseTransferDeletePayload!id: WarehouseTransferID!Permanently delete a warehouse transfer from the caller's tenant. Reports not-found rather than failing when no such transfer exists. Requires warehouseTransfer:delete permission.
deleteWorkCenterDeleteWorkCenterPayload!id: WorkCenterID!Permanently delete a work center from the caller's tenant. Returns success = false when no work center with that id exists. Prefer setting isActive = false to retire a work center that has production history. Requires workCenter:delete permission.
deleteWorkCenterCapabilityDeleteWorkCenterCapabilityPayload!id: WorkCenterCapabilityID!Removes 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.
deleteWorkCenterDeviceDeleteWorkCenterDevicePayload!id: WorkCenterDeviceID!Remove a work center ↔ device binding. Requires workCenter:write.
deleteWorkCenterShiftProfileDeleteWorkCenterShiftProfilePayload!id: WorkCenterShiftProfileID!Permanently deletes a work center shift profile, so the work center no longer runs that shift definition over the profile's window. Requires workCenter:write.
deleteWorkflowDeleteWorkflowPayload!id: WorkflowID!Delete a workflow and all its versions. Requires workflow:delete permission.
deleteWorkflowTriggerWorkflowTriggerPayload!input: DeleteWorkflowTriggerInput!Delete a workflow trigger
deleteWorkflowVersionDeletePayload!id: WorkflowVersionID!Delete one version from a workflow's authoring history. Fails when the workflow is active and this is the version it runs — deactivate it or activate another version first. Requires workflow:delete permission.
deleteWorkspaceDeletePayload!id: WorkspaceID!Delete a workspace and all its versions. Owner for PERSONAL, else workspace:write.
deleteWorkspaceVersionDeletePayload!id: WorkspaceVersionID!Delete one version from a workspace's authoring history. Fails when the version is the one the workspace is currently published at — delete the workspace itself to remove that. Owner for PERSONAL, else workspace:write.
deprecateEdgeAppUpsertEdgeAppPayload!id: EdgeAppID!Mark a PUBLISHED row as DEPRECATED. Used to retire an app without a replacement. Existing installations stay pinned and keep working until upgraded or uninstalled. Idempotent on already-DEPRECATED rows; rejects DRAFT rows (delete them instead). Requires edge_app:write permission.
deprecateIntegrationDefinitionIntegrationDefinitionPayload!input: DeprecateIntegrationDefinitionInput!Deprecate an integration definition. Requires integrationDefinition:write permission.
destroyJobGroupDestroyJobGroupPayload!input: DestroyJobGroupInput!Delete a job group (jobs are unlinked, not deleted). Requires jobGroup:delete permission.
destroyJobGroupAndJobsDestroyJobGroupPayload!input: DestroyJobGroupInput!Delete a job group and all its jobs. Requires jobGroup:delete permission.
detachCustomAppTeamDetachCustomAppTeamPayload!input: DetachCustomAppTeamInput!Detach a team from a custom app. Requires customappteam:write permission.
detachCustomAppUserDetachCustomAppUserPayload!input: DetachCustomAppUserInput!Detach a user from a custom app. Requires customappuser:write permission.
disableWorkflowTriggerWorkflowTriggerPayload!input: DisableWorkflowTriggerInput!Disable a workflow trigger
discoverDeviceJMFDevicesDiscoverJMFDevicesPayload!deviceId: DeviceID!Discover the devices known to a JMF controller (KnownDevices). Requires device:execute permission.
dispatchShipmentDispatchShipmentPayload!input: DispatchShipmentInput!Create a shipment with packages and items, marking it as picked up. Requires shipment:write.
duplicateEstimateForCustomerDuplicateEstimateForCustomerPayload!input: DuplicateEstimateForCustomerInput!Duplicate an estimate for a different customer, optionally adjusting prices. Requires estimate:write.
enableWorkflowTriggerWorkflowTriggerPayload!input: EnableWorkflowTriggerInput!Enable a workflow trigger
executeLuaScriptExecuteScriptPayload!input: ExecuteScriptInput!Execute a Lua script in the playground sandbox. Requires script:execute permission.
executeWorkflowExecuteWorkflowPayload!input: ExecuteWorkflowInput!Start a new workflow execution. Requires workflow:execute permission.
exportCostConfigurationExportCostConfigurationPayload!Export the tenant's cost configuration (categories, rates, operation mappings) as a flat CSV string for spreadsheet editing.
exportDashboardExportDashboardPayload!input: ExportDashboardInput!Export a dashboard and its cards to YAML or JSON. Requires dashboard:read permission.
exportEdgeAppExportEdgeAppPayload!input: ExportEdgeAppInput!Export an edge app to YAML or JSON. Requires edge_app:read permission.
exportIntegrationDefinitionExportIntegrationDefinitionPayload!input: ExportIntegrationDefinitionInput!Export an integration definition to YAML or JSON. Requires integrationDefinition:read permission.
exportWorkflowExportWorkflowPayload!input: ExportWorkflowInput!Export a workflow version to YAML or JSON. Requires workflow:read permission.
extractProductionOperationsExtractProductionOperationsPayload!input: ExtractProductionOperationsInput!Extract ISO 19593-1 production steps from an artwork file and derive Operations (optionally persisting them). Requires operation:write permission.
fileDownloadUrlFileDownloadGrant!id: FileID!Mint a short-lived download URL. Requires file:download permission.
forecastMLModelForecastMLModelPayload!horizon: Int!
id: MLModelConfigID!
level: Float
Forecast future values using a trained time-series model. Requires mlmodelconfig:execute permission.
generateEstimateGenerateEstimatePayload!input: GenerateEstimateInput!Generate an automated estimate by inferring operations, calculating costs, and creating estimate lines. Requires estimate:write permission.
importCostConfigurationImportCostConfigurationPayload!input: ImportCostConfigurationInput!Import cost configuration from a CSV string. Upserts cost categories, operation-to-category mappings, and cost rates in a single transaction.
importDashboardImportDashboardPayload!input: ImportDashboardInput!Import a dashboard from YAML or JSON, creating a new dashboard. Requires dashboard:write permission.
importEdgeAppUpsertEdgeAppPayload!input: ImportEdgeAppInput!Import an edge app from YAML or JSON, landing it as a DRAFT (replaces an existing DRAFT for the handle, or allocates the next version). Requires edge_app:write permission.
importIntegrationDefinitionIntegrationDefinitionPayload!input: ImportIntegrationDefinitionInput!Import an integration definition from YAML or JSON, creating a new DRAFT. Requires integrationDefinition:write permission.
importMLModelConfigImportMLModelConfigPayload!input: ImportMLModelConfigInput!Import an ML model config from JSON or YAML. Requires mlmodelconfig:write permission.
importWorkflowImportWorkflowPayload!input: ImportWorkflowInput!Import a workflow from YAML or JSON, creating a new version. Requires workflow:write permission.
inferOperationsImposedOperationResultOutput!input: InferOperationsInput!Infer the required production operations for a component. Provide either componentId or spec. When imposing config is provided, returns full production-grade DAG.
installCanonicalTemplateUpsertProductTemplatePayload!input: InstallCanonicalTemplateInput!Install a canonical product template (shipped with the app) into the calling tenant as a fresh draft. Requires productTemplate:write permission.
installSharedResourceInstallSharedResourcePayload!templateId: SharedResourceTemplateID!Install a catalog template into the calling tenant, creating or updating the corresponding domain resource and recording the installation with the CoCoCo control plane. Idempotent: re-installing an unchanged template returns the existing resource. Authorization is dynamic — the caller needs write permission on the resource kind the template installs (e.g. script:write for a SCRIPT template, workflow:write for a WORKFLOW one), so it is checked in the resolver once the template has been fetched. Failures are reported in the payload, not as GraphQL errors.
instantiateProductTemplateInstantiateProductTemplatePayload!input: InstantiateProductTemplateInput!Instantiate a published product template into a print job. Requires productTemplate:execute permission.
interrogateDeviceJMFCapabilitiesInterrogateJMFCapabilitiesPayload!deviceId: DeviceID!Interrogate the message services a JMF controller supports (KnownMessages). Requires device:execute permission.
invoiceOrderInvoiceOrderPayload!input: InvoiceOrderInput!Generate an invoice from an order and its lines. Requires invoice:write.
invokeEdgeAppInvokeEdgeAppPayload!input: InvokeEdgeAppInput!Invoke a edgeApp's onMessage export by name on a specific controller (the edgeApp must be installed on it). Forwards to the bridge and returns the function's JSON return value. Requires edge_app:invoke permission.
issueCreditNoteIssueCreditNotePayload!input: IssueCreditNoteInput!Issue a credit note against an invoice. Requires invoice:write.
issueStockToProductionIssueStockToProductionPayload!input: IssueStockToProductionInput!Issue warehouse stock to production, creating transfers and reducing quantities. Requires warehouseStock:write.
lockScheduleScenarioLockScheduleScenarioPayload!id: ScheduleScenarioID!Freeze a schedule scenario by stamping lockedAt, after which every further create/update/upsert against it is rejected. Fails if it is already locked. Requires scheduleScenario:write permission.
markKnowledgeNotesContradictKnowledgeNotePayload!a: KnowledgeNoteID!
b: KnowledgeNoteID!
Record that two notes contradict each other; the conflict is surfaced by retrieveKnowledge via KnowledgeHit.contradicts. Requires knowledgeNote:write permission.
pauseIntegrationInstanceIntegrationInstancePayload!input: PauseIntegrationInstanceInput!Pause an integration instance. Requires integrationInstance:write permission.
performStockCountPerformStockCountPayload!input: PerformStockCountInput!Perform a stock count, adjusting quantities and recording differences. Requires warehouseStock:write.
predictMLModelPredictMLModelPayload!id: MLModelConfigID!
input: String!
Run a prediction using a trained ML model. Requires mlmodelconfig:execute permission.
previewMLModelPipelineDataScriptPreview!id: MLModelConfigID!
sampleLimit: Int
stagesOverride: [MLNormalizationStageInput!]
Run the data pipeline over a sample WITHOUT training and return the emitted fields. Requires mlmodelconfig:execute permission.
publishCustomAppUpsertCustomAppPayload!id: CustomAppID!
versionId: CustomAppVersionID!
Publish a specific version of a custom app, making it visible to end users. Requires customapp:write permission.
publishEdgeAppDraftUpsertEdgeAppPayload!id: EdgeAppID!Freeze a DRAFT and flip it to PUBLISHED. Auto-deprecates the previously-PUBLISHED row for the same handle. Pushes config.update to every controller running an installation that pinned the newly-published row. Requires edge_app:write.
publishIntegrationDraftIntegrationDefinitionPayload!input: PublishIntegrationDraftInput!Validate and publish a draft as an active definition. Requires integrationDefinition:write permission.
publishJourneyJourneyPayload!id: JourneyID!
versionId: JourneyVersionID!
Promote a named draft version of a journey to the live published version. Other open drafts are left untouched. Owner for PERSONAL, else journey:write.
publishMLModelVersionPublishMLModelVersionPayload!configId: MLModelConfigID!
versionId: MLModelConfigVersionID!
Set a version as the published version used for predictions. Requires mlmodelconfig:write permission.
publishProductTemplatePublishProductTemplatePayload!input: PublishProductTemplateInput!Publish a product template version. Requires productTemplate:write permission.
publishTemplateVersionPublishTemplateVersionPayload!input: PublishTemplateVersionInput!Publish current template content as a new version. Requires template:write permission.
publishWorkspaceWorkspacePayload!id: WorkspaceID!
versionId: WorkspaceVersionID!
Promote a named draft version of a workspace to the live published version. Other open drafts are left untouched. Owner for PERSONAL, else workspace:write.
receivePurchaseOrderReceivePurchaseOrderPayload!input: ReceivePurchaseOrderInput!Record receipt of purchase order lines, optionally adding to warehouse stock. Requires purchaseOrder:write.
recordMetricPointsRecordMetricPointsPayload!input: RecordMetricPointsInput!Record one or more data points for a metric. Requires metric:write permission.
recordPaymentOTCRecordPaymentPayload!input: OTCRecordPaymentInput!Record a payment against an invoice: writes a payment ledger row and rolls the payment up onto the invoice (paidAmount, paid/partiallyPaid, paidAt) and its order (paymentStatus), atomically. Requires payment:write permission.
recordProgressPointsRecordProgressPointsPayload!input: RecordProgressPointsInput!Record one or more progress tracking data points. Up to 10,000 points per request. Requires progressPoint:write permission.
recordWorkCenterStatusEventRecordWorkCenterStatusEventPayload!input: RecordWorkCenterStatusEventInput!Record a work centre status transition event. Requires workCenter:write permission.
removeJobFromJobGroupRemoveJobFromJobGroupPayload!input: RemoveJobFromJobGroupInput!Remove a job from its group (job survives). Requires jobGroup:write permission.
renderImpositionSVGRenderImpositionSVGPayload!input: RenderImpositionSVGInput!Render an imposition layout as SVG. Provide either impositionSpecId or layoutJSON. Requires impositionSpec:execute permission.
renderTemplateRenderTemplatePayload!input: RenderTemplateInput!Render a template with context data. Requires template:execute permission.
requestFileUploadsRequestFileUploadsPayload!inputs: [RequestFileUploadInput!]!Allocate one or more cloud upload URLs. Requires file:write permission.
reserveJobMaterialsReserveJobMaterialsPayload!input: ReserveJobMaterialsInput!Attempt to reserve warehouse stock for all pending material reservations on a job. Requires jobMaterialReservation:write permission.
resolveNodeOutputSchemaNodeOutputSchemaPayload!input: ResolveNodeOutputSchemaInput!Resolve the best-effort JSON Schema for a node's output given its config — SwiftLua-inferred for script-backed kinds, falling back to the kind's static declared schema. Requires workflow:read permission.
restoreScriptVersionRestoreScriptVersionPayload!scriptId: ScriptID!
version: Int!
Put an old version's source back on the script. Appends a new version rather than rewinding history. The name and role are not restored, only the source. Requires script:write permission.
restoreTemplateVersionUpsertTemplatePayload!input: RestoreTemplateVersionInput!Restore template content from a previous version. Requires template:write permission.
resumeWorkflowExecutionWorkflowExecutionPayload!id: WorkflowExecutionID!Resume a workflow execution that is waiting for an external signal. Requires workflow:execute permission.
retrainSystemModelsRetrainSystemModelsPayload!Manually trigger retraining of all system-managed ML models for the current tenant. Requires mlmodelconfig:execute permission.
reviseEstimateReviseEstimatePayload!input: ReviseEstimateInput!Create a new revision of an estimate, copying all lines. Requires estimate:write.
revokeControllerTokenDeletePayload!id: ControllerTokenID!Revoke a controller token. Requires controller_token:revoke permission.
revokeDeviceTokenDeletePayload!id: DeviceTokenID!Revoke a device token. Requires device_token:revoke permission.
rollDataClipShareTokenRollShareTokenPayload!input: RollShareTokenInput!Roll/regenerate the share token for a data clip, invalidating old links
runIntegrationTimerIntegrationInstancePayload!input: RunIntegrationTimerInput!Manually fire a named timer on a running integration instance. Requires integrationInstance:write permission.
runPreflightRunPreflightPayload!input: RunPreflightInput!Run the PrepressKit preflight engine on an artwork file and persist the report. Requires preflightReport:write permission.
sendChatMessageChatMessageResponse!input: SendChatMessageInput!Send a message to a chat session and receive an AI response. Requires chatsession:write permission.
setActiveVersionSetActiveVersionPayload!versionId: WorkflowVersionID
workflowId: WorkflowID!
Set the active version of a workflow. Requires workflow:write permission.
setControllerJMFConfigSetControllerJMFConfigPayload!input: SetControllerJMFConfigInput!Configure JMF on a controller (generates basic-auth credentials when enabled). Requires controller:write.
setCustomAppEngineVersionUpsertCustomAppPayload!input: SetCustomAppEngineVersionInput!Upgrade a custom app's engine to v2 after a script-shape lint. Requires customapp:write permission.
setIntegrationInstanceSecretIntegrationInstancePayload!id: IntegrationInstanceID!
key: String!
value: String!
Set one secret on an integration instance. Secrets are not settable through config — this is the only way in. Requires integrationInstance:write permission.
setWorkCenterDeviceJMFDeviceIDSetWorkCenterDeviceJMFDeviceIDPayload!input: SetWorkCenterDeviceJMFDeviceIDInput!Set the JMF DeviceID on a work center ↔ device binding for inbound correlation. Requires workCenter:write.
startIntegrationInstanceIntegrationInstancePayload!input: StartIntegrationInstanceInput!Start an integration instance. Requires integrationInstance:write permission.
startScheduleOptimizationStartOptimizationPayload!input: StartOptimizationInput!Start a background schedule optimization. Returns immediately with the run ID. Use scheduleOptimizationProgress subscription to stream progress.
testAIAdapterTestAIAdapterPayload!id: AIAdapterID!Test an AI adapter connection. Requires aiadapter:read permission.
testFolderFolderProbeResult!id: FolderID!Checks that a folder's bound transport is reachable by stat-ing a sentinel key; the key being absent still counts as reachable. Read-only — nothing is written, and no folder state changes. Requires folder:read permission.
testStorageBackendStorageBackendProbeResult!id: StorageBackendID!Probe a storage backend's connectivity with its stored credentials (a bucket/root head — nothing is written). Never throws: a failure comes back as ok: false with a reason. Requires storageBackend:read permission.
trainMLModelTrainMLModelPayload!id: MLModelConfigID!Trigger training for an ML model. Requires mlmodelconfig:execute permission.
transitionOperationTransitionOperationPayload!input: TransitionOperationInput!Transition operation to a new status. Requires operation:execute permission.
transitionOperationItemUpsertOperationItemPayload!input: TransitionOperationItemInput!Transition operation item to a new status. Requires operation:execute permission.
transitionTaskTaskPayload!input: TransitionTaskInput!Transition a task's status. Requires task:transition permission.
uncancelMilestoneMilestonePayload!input: CompleteMilestoneInput!Clear the cancellation state of a milestone. Requires milestone:write permission.
uncompleteMilestoneMilestonePayload!input: CompleteMilestoneInput!Mark a milestone as not completed. Requires milestone:write permission.
unmarkKnowledgeNotesContradictKnowledgeNotePayload!a: KnowledgeNoteID!
b: KnowledgeNoteID!
Remove a previously recorded contradiction between two notes. Requires knowledgeNote:write permission.
updateAddressUpsertAddressPayload!id: AddressID!
input: UpdateAddressInput!
Update an address. Only provided fields are changed. Requires address:write permission.
updateAIAdapterUpsertAIAdapterPayload!id: AIAdapterID!
input: UpdateAIAdapterInput!
Update an AI adapter. Only provided fields are changed. Requires aiadapter:write permission.
updateAIAgentUpsertAIAgentPayload!id: AIAgentID!
input: UpdateAIAgentInput!
Update an AI agent. Only provided fields are changed. Requires aiAgent:write permission.
updateBusinessUnitUpsertBusinessUnitPayload!id: BusinessUnitID!
input: UpdateBusinessUnitInput!
Update a business unit. Only provided fields are changed. Requires businessunit:write permission.
updateCapabilityUpsertCapabilityPayload!id: CapabilityID!
input: UpdateCapabilityInput!
Update a capability. Only provided fields are changed. Requires capability:write permission.
updateCarrierUpsertCarrierPayload!id: CarrierID!
input: UpdateCarrierInput!
Update a carrier. Only provided fields are changed. Requires carrier:write permission.
updateChatSessionChatSessionPayload!input: UpdateChatSessionInput!Update an existing chat session. Requires chatsession:write permission.
updateComponentUpsertComponentPayload!id: ComponentID!
input: UpdateComponentInput!
Update a component. Only provided fields are changed. Requires component:write permission.
updateComponentGroupUpsertComponentGroupPayload!id: ComponentGroupID!
input: UpdateComponentGroupInput!
Update a component section. Only provided fields are changed. Requires componentGroup:write permission.
updateConceptConceptPayload!input: UpdateConceptInput!Rename or reclassify an existing concept. Requires concept:write permission.
updateContactUpsertContactPayload!id: ContactID!
input: UpdateContactInput!
Update a contact. Only provided fields are changed. Requires contact:write permission.
updateControllerUpsertControllerPayload!id: ControllerID!
input: UpdateControllerInput!
Update a controller. Only provided fields are changed. Requires controller:write permission.
updateControllerPolicyUpsertControllerPolicyPayload!id: ControllerPolicyID!
input: UpdateControllerPolicyInput!
Update a controller policy. Only provided fields are changed. The referenced controller must exist in this tenant. Triggers a config.update push to the controller. Requires controller_policy:write permission.
updateCostCategoryUpsertCostCategoryPayload!id: CostCategoryID!
input: UpdateCostCategoryInput!
Update a cost category in place. Only provided fields are changed. Requires costcategory:write permission.
updateCostCenterUpsertCostCenterPayload!id: CostCenterID!
input: UpdateCostCenterInput!
Update a cost center. Only provided fields are changed. Requires costcenter:write permission.
updateCostRateUpsertCostRatePayload!id: CostRateID!
input: UpdateCostRateInput!
Update a cost rate in place (does not create a new version, unlike upsertCostRate). Only provided fields are changed. Requires costrate:write permission.
updateCustomAppUpsertCustomAppPayload!id: CustomAppID!
input: UpdateCustomAppInput!
Update a custom app. Only provided fields are changed. Requires customapp:write permission.
updateCustomDataContainerUpsertCustomDataContainerPayload!id: CustomDataContainerID!
input: UpdateCustomDataContainerInput!
Update a custom data container. Only provided fields are changed. Requires customapp:write permission.
updateCustomerUpsertCustomerPayload!id: CustomerID!
input: UpdateCustomerInput!
Update a customer. Only provided fields are changed. Requires customer:write permission.
updateCustomerPriceOverrideUpsertCustomerPriceOverridePayload!id: CustomerPriceOverrideID!
input: UpdateCustomerPriceOverrideInput!
Update a customer price override. Only provided fields are changed. Requires customerPriceOverride:write permission.
updateCustomWorkflowActionUpsertCustomWorkflowActionPayload!id: CustomWorkflowActionID!
input: UpdateCustomWorkflowActionInput!
Update a custom action. Only provided fields are changed. Requires customWorkflowAction:write permission.
updateDashboardUpsertDashboardPayload!id: DashboardID!
input: UpdateDashboardInput!
Update a dashboard. Only provided fields are changed. Requires dashboard:write permission.
updateDashboardCardUpsertDashboardCardPayload!cardId: DashboardCardID!
dashboardId: DashboardID!
input: UpdateDashboardCardInput!
Update a dashboard card in place. Only the dashboard owner may. Requires dashboard:write permission.
updateDashboardLayoutUpdateDashboardLayoutPayload!input: UpdateDashboardLayoutInput!Bulk update card positions after drag/resize operations. Requires dashboard:write permission.
updateDataClipUpsertDataClipPayload!id: DataClipID!
input: UpdateDataClipInput!
Update a data clip
updateDataRecordUpsertDataRecordPayload!id: DataRecordID!
input: UpdateDataRecordInput!
Update a data record. Only provided fields are changed. Requires datarecord:write permission.
updateDataSchemaUpsertDataSchemaPayload!id: DataSchemaID!
input: UpdateDataSchemaInput!
Update a data schema. Only provided fields are changed. Requires dataschema:write permission.
updateDeviceUpsertDevicePayload!id: DeviceID!
input: UpdateDeviceInput!
Update a device. Only provided fields are changed. Requires device:write permission.
updateEdgeAppUpsertEdgeAppPayload!id: EdgeAppID!
input: UpdateEdgeAppInput!
Update an existing DRAFT edge app row. Rejects PUBLISHED/DEPRECATED rows (frozen) and attempts to change handle (immutable on an existing draft). Only provided fields are changed. Requires edge_app:write permission.
updateEdgeAppInstallationUpsertEdgeAppInstallationPayload!id: EdgeAppInstallationID!
input: UpdateEdgeAppInstallationInput!
Update a edgeApp installation. Only provided fields are changed; edgeAppId is immutable (delete and recreate to change it). Re-validates the controller and bot user (if changed) and variables against the edgeApp's configSchema. Pushes config.update to the controller. Requires edge_app_installation:write permission.
updateEstimateUpsertEstimatePayload!id: EstimateID!
input: UpdateEstimateInput!
Update an estimate. Only provided fields are changed. Requires estimate:write permission.
updateEstimateLineUpsertEstimateLinePayload!id: EstimateLineID!
input: UpdateEstimateLineInput!
Update an estimate line. Only provided fields are changed. Requires estimate:write permission.
updateExternalSchemaUpsertExternalSchemaPayload!id: ExternalSchemaID!
input: UpdateExternalSchemaInput!
Update an external schema. Only provided fields are changed. Triggers background processing if sourceText is changed. Requires externalSchema:write permission.
updateFileUpsertFilePayload!id: FileID!
input: UpdateFileInput!
Update a file. Only provided fields are changed. Requires file:write permission.
updateFolderFolderPayload!input: UpdateFolderInput!Patches a folder. Omitted fields are left unchanged. A folder that files already reference may not have its binding or root path changed (stored file handles would resolve against the wrong transport/prefix), and the tenant default may be moved to another folder but never simply unset. Requires folder:write permission.
updateIncomingWebhookUpsertIncomingWebhookPayload!id: IncomingWebhookID!
input: UpdateIncomingWebhookInput!
Update an incoming webhook. Only provided fields are changed. Requires incomingWebhook:write permission.
updateIntegrationDataContainerUpsertIntegrationDataContainerPayload!id: IntegrationDataContainerID!
input: UpdateIntegrationDataContainerInput!
Update an integration data container. Only provided fields are changed. Requires integrationDataContainer:write permission.
updateIntegrationDraftFileIntegrationDefinitionPayload!input: UpdateIntegrationDraftFileInput!Update a single file in a draft's bundle. Requires integrationDefinition:write permission.
updateIntegrationDraftManifestIntegrationDefinitionPayload!input: UpdateIntegrationDraftManifestInput!Update manifest fields on a draft. Requires integrationDefinition:write permission.
updateIntegrationInstanceIntegrationInstancePayload!input: UpdateIntegrationInstanceInput!Update an integration instance. Requires integrationInstance:write permission.
updateInvoiceUpsertInvoicePayload!id: InvoiceID!
input: UpdateInvoiceInput!
Update an existing invoice. Requires invoice:write permission.
updateInvoiceLineUpsertInvoiceLinePayload!id: InvoiceLineID!
input: UpdateInvoiceLineInput!
Update an invoice line. Only provided fields are changed. Requires invoice:write permission.
updateJobUpsertJobPayload!id: JobID!
input: UpdateJobInput!
Update a job. Only provided fields are changed. Requires job:write permission.
updateJobMaterialReservationUpsertJobMaterialReservationPayload!id: JobMaterialReservationID!
input: UpdateJobMaterialReservationInput!
Update a job material reservation. Only provided fields are changed. Requires jobMaterialReservation:write permission.
updateJourneyJourneyPayload!id: JourneyID!
input: UpdateJourneyInput!
Patch an existing journey — only provided fields are changed. Owner for PERSONAL, else journey:write.
updateKnowledgeNoteKnowledgeNotePayload!input: UpdateKnowledgeNoteInput!Edit a note's body or scope, or supersede it with a replacement. The attachment is immutable. Requires knowledgeNote:write permission.
updateMetricUpsertMetricPayload!id: MetricID!
input: UpdateMetricInput!
Update a metric. Only provided fields are changed. Requires metric:write permission.
updateMilestoneMilestonePayload!id: MilestoneID!
input: UpdateMilestoneInput!
Update a milestone. Only provided fields are changed. Requires milestone:write permission.
updateMLModelConfigUpsertMLModelConfigPayload!id: MLModelConfigID!
input: UpdateMLModelConfigInput!
Update an ML model config. Only provided fields are changed. Requires mlmodelconfig:write permission.
updateNetworkUpsertNetworkPayload!id: NetworkID!
input: UpdateNetworkInput!
Update a network. Only provided fields are changed. Requires network:write permission.
updateNotificationGroupUpsertNotificationGroupPayload!id: NotificationGroupID!
input: UpdateNotificationGroupInput!
Update a notification group. Requires notificationGroup:write permission.
updateNotificationRecipientUpsertNotificationRecipientPayload!id: NotificationRecipientID!
input: UpdateNotificationRecipientInput!
Update a notification recipient. Requires notificationRecipient:write permission.
updateOperationUpsertOperationPayload!id: OperationID!
input: UpdateOperationInput!
Update an operation. Only provided fields are changed. Requires operation:write permission.
updateOperationCostMappingUpsertOperationCostMappingPayload!id: OperationCostMappingID!
input: UpdateOperationCostMappingInput!
Update an operation cost mapping. Only provided fields are changed. Requires costcategory:write permission.
updateOperationEdgeUpsertOperationGraphPayload!id: OperationEdgeID!
input: UpdateOperationEdgeInput!
Update a single operation dependency edge. Only provided fields are changed. Requires operation:write permission.
updateOperationItemUpsertOperationItemPayload!id: OperationItemID!
input: UpdateOperationItemInput!
Update an operation item. Only provided fields are changed. Requires operation:write permission.
updateOperationItemEdgeUpsertOperationItemEdgesPayload!id: OperationItemEdgeID!
input: UpdateOperationItemEdgeInput!
Patch a single item-level dependency edge. Requires operation:write permission.
updateOrderUpsertOrderPayload!id: OrderID!
input: UpdateOrderInput!
Update an order. Only provided fields are changed. Requires order:write permission.
updateOrderLineUpsertOrderLinePayload!id: OrderLineID!
input: UpdateOrderLineInput!
Update an order line. Only provided fields are changed. Requires order:write permission.
updatePriceBracketUpsertPriceBracketPayload!id: PriceBracketID!
input: UpdatePriceBracketInput!
Update a price bracket. Only provided fields are changed. Requires priceBracket:write permission.
updateProductUpsertProductPayload!id: ProductID!
input: UpdateProductInput!
Update a product. Only provided fields are changed. Requires product:write permission.
updateProductionCellUpsertProductionCellPayload!id: ProductionCellID!
input: UpdateProductionCellInput!
Update a production cell. Only provided fields are changed. Requires productionCell:write permission.
updateProductionPlanUpsertProductionPlanPayload!id: ProductionPlanID!
input: UpdateProductionPlanInput!
Update a production plan. Only provided fields are changed. Requires productionPlan:write permission.
updateProductTemplateUpsertProductTemplatePayload!id: ProductTemplateID!
input: UpdateProductTemplateInput!
Update a product template. Only provided fields are changed. Requires productTemplate:write permission.
updateProtobufSchemaUpsertProtobufSchemaPayload!id: ProtobufSchemaID!
input: UpdateProtobufSchemaInput!
Update a protobuf schema. Only provided fields are changed. Requires protobufSchema:write permission.
updatePurchaseOrderUpsertPurchaseOrderPayload!id: PurchaseOrderID!
input: UpdatePurchaseOrderInput!
Update a purchase order. Only provided fields are changed. Requires purchaseOrder:write permission.
updatePurchaseOrderLineUpsertPurchaseOrderLinePayload!id: PurchaseOrderLineID!
input: UpdatePurchaseOrderLineInput!
Update a purchase order line. Only provided fields are changed. Requires purchaseOrder:write permission.
updateRecordedCostUpsertRecordedCostPayload!id: RecordedCostID!
input: UpdateRecordedCostInput!
Update a recorded cost. Only provided fields are changed. Requires recordedcost:write permission.
updateScheduleAllocationUpsertScheduleAllocationPayload!id: ScheduleAllocationID!
input: UpdateScheduleAllocationInput!
Update a schedule allocation. Only provided fields are changed. Requires scheduleScenario:write permission.
updateScheduleScenarioUpsertScheduleScenarioPayload!id: ScheduleScenarioID!
input: UpdateScheduleScenarioInput!
Update a schedule scenario. Only provided fields are changed. Requires scheduleScenario:write permission.
updateScriptUpsertScriptPayload!id: ScriptID!
input: UpdateScriptInput!
Update a script. Only provided fields are changed. Requires script:write permission.
updateShiftDefinitionUpsertShiftDefinitionPayload!id: ShiftDefinitionID!
input: UpdateShiftDefinitionInput!
Patch an existing shift definition and stamp updatedAt. An unknown id, and any validation failure, come back as payload errors rather than as a GraphQL error. Requires shiftDefinition:write permission.
updateShipmentUpsertShipmentPayload!id: ShipmentID!
input: UpdateShipmentInput!
Update a shipment. Only provided fields are changed. Requires shipment:write permission.
updateShipmentItemUpsertShipmentItemPayload!id: ShipmentItemID!
input: UpdateShipmentItemInput!
Update a shipment item. Only provided fields are changed. Requires shipment:write permission.
updateShipmentPackageUpsertShipmentPackagePayload!id: ShipmentPackageID!
input: UpdateShipmentPackageInput!
Update a shipment package. Only provided fields are changed. Requires shipment:write permission.
updateShipmentTrackingUpdateShipmentTrackingPayload!input: UpdateShipmentTrackingInput!Update shipment status and tracking details. Requires shipment:write.
updateStorageBackendUpsertStorageBackendPayload!id: StorageBackendID!
input: UpdateStorageBackendInput!
Update a storage backend. Only provided fields are changed. Requires storageBackend:write permission.
updateSubstrateUpsertSubstratePayload!id: SubstrateID!
input: UpdateSubstrateInput!
Update a substrate in place. Only provided fields are changed. Requires substrate:write permission.
updateSubstrateTemplateLineUpsertSubstrateTemplateLinePayload!id: SubstrateTemplateLineID!
input: UpdateSubstrateTemplateLineInput!
Update a substrate template line in place. Only provided fields are changed. Requires substrateTemplateLine:write permission.
updateSupplierUpsertSupplierPayload!id: SupplierID!
input: UpdateSupplierInput!
Update a supplier. Only provided fields are changed. Requires supplier:write permission.
updateTaxCodeUpsertTaxCodePayload!id: TaxCodeID!
input: UpdateTaxCodeInput!
Update a tax code. Only provided fields are changed. Requires taxCode:write permission.
updateTemplateUpsertTemplatePayload!id: TemplateID!
input: UpdateTemplateInput!
Update a template. Only provided fields are changed. Requires template:write permission.
updateWarehouseLocationWarehouseLocationPayload!id: WarehouseLocationID!
input: UpdateWarehouseLocationInput!
Apply a partial update to an existing warehouse location and emit an updated event. Returns an error payload when the id is unknown in the caller's tenant or the result fails validation. Requires warehouseLocation:write permission.
updateWarehouseStockWarehouseStockPayload!id: WarehouseStockID!
input: UpdateWarehouseStockInput!
Patch an existing warehouse stock record in the caller's tenant. Returns an id error when the record does not exist, or validation errors when the patched quantities are invalid. Emits a warehouse-stock updated event. Requires write access to warehouse stock.
updateWarehouseTransferWarehouseTransferPayload!id: WarehouseTransferID!
input: UpdateWarehouseTransferInput!
Apply a partial update to an existing warehouse transfer. Returns an error payload when the transfer does not exist, and validation errors when the result would have a matching source and destination or a non-positive quantity. Requires warehouseTransfer:write permission.
updateWorkCenterUpsertWorkCenterPayload!id: WorkCenterID!
input: UpdateWorkCenterInput!
Update a work center. Only provided fields are changed. Requires workCenter:write permission.
updateWorkCenterCapabilityUpsertWorkCenterCapabilityPayload!id: WorkCenterCapabilityID!
input: UpdateWorkCenterCapabilityInput!
Patches an existing work center capability assignment and refreshes its updatedAt. Returns an "id" error when no such assignment exists in the caller's tenant, and persists nothing if a constraint URI fails validation. Requires workCenter:write permission.
updateWorkCenterDeviceUpsertWorkCenterDevicePayload!id: WorkCenterDeviceID!
input: UpdateWorkCenterDeviceInput!
Update a work center ↔ device binding. Only provided fields are changed. Requires workCenter:write.
updateWorkCenterShiftProfileUpsertWorkCenterShiftProfilePayload!id: WorkCenterShiftProfileID!
input: UpdateWorkCenterShiftProfileInput!
Partially updates an existing work center shift profile. Returns an id error when no such profile exists in the caller's tenant. Requires workCenter:write.
updateWorkflowWorkflowPayload!input: UpdateWorkflowInput!Update an existing workflow. Requires workflow:write permission.
updateWorkflowTriggerWorkflowTriggerPayload!input: UpdateWorkflowTriggerInput!Update an existing workflow trigger
updateWorkspaceWorkspacePayload!id: WorkspaceID!
input: UpdateWorkspaceInput!
Update a workspace. Only provided fields are changed. Owner for PERSONAL, else workspace:write.
upgradeEdgeAppInstallationUpsertEdgeAppInstallationPayload!input: UpgradeEdgeAppInstallationInput!Repoint an installation at a different version of the same edgeApp. Validates the target row exists, belongs to this tenant, shares the installation's current handle, and isn't a DRAFT (only PUBLISHED or DEPRECATED versions can be pinned). Pushes config.update to the controller. The bridge reconciles by installation.id+version, so the new version triggers a restart with the new content. Requires edge_app_installation:write.
upgradeIntegrationInstanceIntegrationInstancePayload!input: UpgradeIntegrationInstanceInput!Move an integration instance to a newer version of the same integration. Runs the new definition's upgrade hook between stop and start. Requires integrationInstance:write permission.
upsertAddressUpsertAddressPayload!input: UpsertAddressInput!Create or update an address. Requires address:write permission.
upsertAIAdapterUpsertAIAdapterPayload!input: UpsertAIAdapterInput!Create or update an AI adapter. Requires aiadapter:write permission.
upsertAIAgentUpsertAIAgentPayload!input: UpsertAIAgentInput!Create or update an AI agent. Requires aiAgent:write permission.
upsertBusinessUnitUpsertBusinessUnitPayload!input: UpsertBusinessUnitInput!Create or update a business unit. Requires businessunit:write permission.
upsertCapabilityUpsertCapabilityPayload!input: UpsertCapabilityInput!Create a capability, or replace an existing one wholesale when input.id is given. Unlike createCapability/updateCapability this does not reject a duplicate code. The capability is written under the caller's tenant. Requires capability:write permission.
upsertCarrierUpsertCarrierPayload!input: UpsertCarrierInput!Create or update a carrier. Requires carrier:write permission.
upsertComponentUpsertComponentPayload!input: UpsertComponentInput!Create or update a component. Requires component:write permission.
upsertComponentArtworkFileUpsertComponentArtworkFilePayload!input: UpsertComponentArtworkFileInput!Add or update an artwork file reference on a component. Requires componentArtworkFile:write permission.
upsertComponentGroupUpsertComponentGroupPayload!input: UpsertComponentGroupInput!Create or update a component section. Requires componentGroup:write permission.
upsertContactUpsertContactPayload!input: UpsertContactInput!Create or update a contact. Requires contact:write permission.
upsertControllerUpsertControllerPayload!input: UpsertControllerInput!Create or update a controller. Requires controller:write permission.
upsertControllerPolicyUpsertControllerPolicyPayload!input: UpsertControllerPolicyInput!Create or update the policy for a controller. Idempotent on controllerId (one row per controller). Wholesale-replace on both allowlists. Triggers a config.update push to the controller. Requires controller_policy:write permission.
upsertCostCategoryUpsertCostCategoryPayload!input: UpsertCostCategoryInput!Create or update a cost category. Requires costcategory:write permission.
upsertCostCenterUpsertCostCenterPayload!input: UpsertCostCenterInput!Create or update a cost center. Requires costcenter:write permission.
upsertCostRateUpsertCostRatePayload!input: UpsertCostRateInput!Create or update a cost rate. Updates create a new version for audit trail. Requires costrate:write permission.
upsertCustomAppUpsertCustomAppPayload!input: UpsertCustomAppInput!Create or update a custom app. Requires customapp:write permission.
upsertCustomDataContainerUpsertCustomDataContainerPayload!input: UpsertCustomDataContainerInput!Create or update a custom data container. Requires customapp:write permission.
upsertCustomerUpsertCustomerPayload!input: UpsertCustomerInput!Create or update a customer. Requires customer:write permission.
upsertCustomerPriceOverrideUpsertCustomerPriceOverridePayload!input: UpsertCustomerPriceOverrideInput!Create or update a customer price override. Requires customerPriceOverride:write permission.
upsertCustomWorkflowActionUpsertCustomWorkflowActionPayload!input: UpsertCustomWorkflowActionInput!Create a custom action, or overwrite an existing one when input.id is supplied. Overwrite semantics: omitted optional fields are written as null, unlike updateCustomWorkflowAction. Requires customWorkflowAction:write permission.
upsertDashboardUpsertDashboardPayload!input: UpsertDashboardInput!Create or update a dashboard. Requires dashboard:write permission.
upsertDashboardCardUpsertDashboardCardPayload!input: UpsertDashboardCardInput!Create or update a card within a dashboard. Requires dashboard:write permission.
upsertDataClipUpsertDataClipPayload!input: UpsertDataClipInput!Create or update a data clip
upsertDataRecordUpsertDataRecordPayload!input: UpsertDataRecordInput!Create or update a data record. Requires datarecord:write permission.
upsertDataSchemaUpsertDataSchemaPayload!input: UpsertDataSchemaInput!Create or update a data schema. Requires dataschema:write permission.
upsertDeviceUpsertDevicePayload!input: UpsertDeviceInput!Create or update a device. Requires device:write permission.
upsertEdgeAppUpsertEdgeAppPayload!input: UpsertEdgeAppInput!Create or update a DRAFT edge app row. With input.id: edits the existing draft (rejects PUBLISHED/DEPRECATED rows — those are frozen). Without input.id: creates a new draft for the handle (rejects if a draft already exists). Drafts aren't pushed to controllers; use publishEdgeAppDraft to ship. Requires edge_app:write permission.
upsertEdgeAppInstallationUpsertEdgeAppInstallationPayload!input: UpsertEdgeAppInstallationInput!Create or update a edgeApp installation. Validates variables against the edgeApp's configSchema (when set) and pushes config.update to the target controller. Requires edge_app_installation:write permission.
upsertEstimateUpsertEstimatePayload!input: UpsertEstimateInput!Create or update an estimate. Requires estimate:write permission.
upsertEstimateLineUpsertEstimateLinePayload!input: UpsertEstimateLineInput!Create or update an estimate line. Requires estimate:write permission.
upsertExternalSchemaUpsertExternalSchemaPayload!input: UpsertExternalSchemaInput!Create or update an external schema. Triggers background processing. Requires externalSchema:write permission.
upsertFileUpsertFilePayload!input: UpsertFileInput!Create or update an external-backed file. Cloud-backed files use requestFileUploads. Requires file:write permission.
upsertImpositionSpecUpsertImpositionSpecPayload!input: UpsertImpositionSpecInput!Add or update an imposition spec on a component. Requires impositionSpec:write permission.
upsertIncomingWebhookUpsertIncomingWebhookPayload!input: UpsertIncomingWebhookInput!Create or update an incoming webhook. Requires incomingWebhook:write permission.
upsertIntegrationDataContainerUpsertIntegrationDataContainerPayload!input: UpsertIntegrationDataContainerInput!Create or update an integration data container. Requires integrationDataContainer:write permission.
upsertInvoiceUpsertInvoicePayload!input: UpsertInvoiceInput!Create or update an invoice. Requires invoice:write permission.
upsertInvoiceLineUpsertInvoiceLinePayload!input: UpsertInvoiceLineInput!Create or update an invoice line. Requires invoice:write permission.
upsertJobUpsertJobPayload!input: UpsertJobInput!Create or update a job. Requires job:write permission.
upsertJobMaterialReservationUpsertJobMaterialReservationPayload!input: UpsertJobMaterialReservationInput!Create or update a job material reservation. Requires jobMaterialReservation:write permission.
upsertJourneyJourneyPayload!input: UpsertJourneyInput!Create a journey or overwrite its open draft. PERSONAL is self-service; TEAM/INSTANCE require journey:write.
upsertMetricUpsertMetricPayload!input: UpsertMetricInput!Create or update a metric. Requires metric:write permission.
upsertMilestoneMilestonePayload!input: UpsertMilestoneInput!Create or update a milestone. Requires milestone:write permission.
upsertMLModelConfigUpsertMLModelConfigPayload!input: UpsertMLModelConfigInput!Create or update an ML model config. Requires mlmodelconfig:write permission.
upsertNetworkUpsertNetworkPayload!input: UpsertNetworkInput!Create or update a network. Requires network:write permission.
upsertOperationUpsertOperationPayload!input: UpsertOperationInput!Create or update an operation. Requires operation:write permission.
upsertOperationCostMappingUpsertOperationCostMappingPayload!input: UpsertOperationCostMappingInput!Create or update an operation cost mapping. Requires costcategory:write permission.
upsertOperationGraphUpsertOperationGraphPayload!input: UpsertOperationGraphInput!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. Validation (endpoints in-job, no self-loops, no duplicates, no cycles) runs before anything is written; on failure nothing changes and the errors are returned in the payload. Requires operation:write permission.
upsertOperationItemUpsertOperationItemPayload!input: UpsertOperationItemInput!Create or update a single operation item. Requires operation:write permission.
upsertOperationItemEdgesUpsertOperationItemEdgesPayload!input: UpsertOperationItemEdgesInput!Batch upsert item-level dependency edges. Requires operation:write permission.
upsertOperationItemsUpsertOperationItemsPayload!input: UpsertOperationItemsInput!Batch upsert operation items for an operation (replaces all existing items). Requires operation:write permission.
upsertOrderUpsertOrderPayload!input: UpsertOrderInput!Create or update an order. Requires order:write permission.
upsertOrderLineUpsertOrderLinePayload!input: UpsertOrderLineInput!Create or update an order line. Requires order:write permission.
upsertPreflightReportUpsertPreflightReportPayload!input: UpsertPreflightReportInput!Create or update a preflight report on a component. Requires preflightReport:write permission.
upsertPrepressOperationUpsertPrepressOperationPayload!input: UpsertPrepressOperationInput!Create or update a prepress operation on a component. Requires prepressOperation:write permission.
upsertPriceBracketUpsertPriceBracketPayload!input: UpsertPriceBracketInput!Create or update a price bracket. Requires priceBracket:write permission.
upsertProductUpsertProductPayload!input: UpsertProductInput!Create or update a product. Requires product:write permission.
upsertProductionCellUpsertProductionCellPayload!input: UpsertProductionCellInput!Create a production cell, or fully overwrite an existing one when input.id names one in the caller's tenant. Requires productionCell:write permission.
upsertProductionPlanUpsertProductionPlanPayload!input: UpsertProductionPlanInput!Create or overwrite a production plan together with its full set of planned operations and edges, in one transaction. Children are replaced wholesale (delete-then-insert). Validation failures are returned in the payload's errors rather than thrown. Requires productionPlan:write permission.
upsertProductTemplateUpsertProductTemplatePayload!input: UpsertProductTemplateInput!Create or update a product template. Requires productTemplate:write permission.
upsertProtobufSchemaUpsertProtobufSchemaPayload!input: UpsertProtobufSchemaInput!Create or update a protobuf schema. Requires protobufSchema:write permission.
upsertPurchaseOrderUpsertPurchaseOrderPayload!input: UpsertPurchaseOrderInput!Create or update a purchase order. Requires purchaseOrder:write permission.
upsertPurchaseOrderLineUpsertPurchaseOrderLinePayload!input: UpsertPurchaseOrderLineInput!Create or update a purchase order line. Requires purchaseOrder:write permission.
upsertRecordedCostUpsertRecordedCostPayload!input: UpsertRecordedCostInput!Record an actual cost incurred. Requires recordedcost:write permission.
upsertScheduleAllocationUpsertScheduleAllocationPayload!input: UpsertScheduleAllocationInput!Create a schedule allocation, or overwrite an existing one when input.id is supplied (createdAt is preserved). Requires scheduleScenario:write permission.
upsertScheduleScenarioUpsertScheduleScenarioPayload!input: UpsertScheduleScenarioInput!Create a schedule scenario, or fully replace an existing one when input.id is given. Rejected when the target scenario is locked. Requires scheduleScenario:write permission.
upsertScriptUpsertScriptPayload!input: UpsertScriptInput!Create or update a script. Requires script:write permission.
upsertShiftDefinitionUpsertShiftDefinitionPayload!input: UpsertShiftDefinitionInput!Create or overwrite a shift definition in one call. When input.id names an existing definition its createdAt is preserved; otherwise a new "shd" TypeID is minted. Validation failures come back as payload errors rather than as a GraphQL error. Requires shiftDefinition:write permission.
upsertShipmentUpsertShipmentPayload!input: UpsertShipmentInput!Create or update a shipment. Requires shipment:write permission.
upsertShipmentItemUpsertShipmentItemPayload!input: UpsertShipmentItemInput!Create or update a shipment item. Requires shipment:write permission.
upsertShipmentPackageUpsertShipmentPackagePayload!input: UpsertShipmentPackageInput!Create or update a shipment package. Requires shipment:write permission.
upsertStorageBackendUpsertStorageBackendPayload!input: UpsertStorageBackendInput!Create or update a storage backend in one call. Prefer createStorageBackend / updateStorageBackend, which have the same validation but distinct create/update semantics. Requires storageBackend:write permission.
upsertSubstrateUpsertSubstratePayload!input: UpsertSubstrateInput!Create or update a substrate. Requires substrate:write permission.
upsertSubstrateTemplateLineUpsertSubstrateTemplateLinePayload!input: UpsertSubstrateTemplateLineInput!Create or update a substrate template line. Requires substrateTemplateLine:write permission.
upsertSupplierUpsertSupplierPayload!input: UpsertSupplierInput!Create or update a supplier. Requires supplier:write permission.
upsertTaxCodeUpsertTaxCodePayload!input: UpsertTaxCodeInput!Create or update a tax code. Requires taxCode:write permission.
upsertTemplateUpsertTemplatePayload!input: UpsertTemplateInput!Create or update a template. Requires template:write permission.
upsertWarehouseLocationWarehouseLocationPayload!input: UpsertWarehouseLocationInput!Create or fully replace a warehouse location by id, preserving the original createdAt when it already exists, and emit an updated event. Because the whole state is written, omitted optional fields are reset to their defaults. Requires warehouseLocation:write permission.
upsertWarehouseStockWarehouseStockPayload!input: UpsertWarehouseStockInput!Create or wholesale-replace a warehouse stock record in the caller's tenant: creates one when input.id is omitted or unknown, otherwise overwrites the existing record. Emits a warehouse-stock updated event. Requires write access to warehouse stock.
upsertWarehouseTransferWarehouseTransferPayload!input: UpsertWarehouseTransferInput!Create a warehouse transfer, or wholly replace an existing one when input.id is supplied. Returns validation errors instead of saving when source and destination match or quantity is not positive. Requires warehouseTransfer:write permission.
upsertWorkCenterUpsertWorkCenterPayload!input: UpsertWorkCenterInput!Create a work center, or fully overwrite an existing one when input.id matches one in the caller's tenant. Unlike updateWorkCenter this replaces every field, so omitted optional fields are cleared. Requires workCenter:write permission.
upsertWorkCenterCapabilityUpsertWorkCenterCapabilityPayload!input: UpsertWorkCenterCapabilityInput!Creates or wholly overwrites a work center capability assignment. Unlike update, every field is taken from the input, so omitted constraints clear the stored list; an existing record keeps its original createdAt. Requires workCenter:write permission.
upsertWorkCenterDeviceUpsertWorkCenterDevicePayload!input: UpsertWorkCenterDeviceInput!Bind a controller device to a work center (or update its priority/active flag). Requires workCenter:write.
upsertWorkCenterShiftProfileUpsertWorkCenterShiftProfilePayload!input: UpsertWorkCenterShiftProfileInput!Creates a work center shift profile, or fully replaces an existing one when input.id is supplied (createdAt is preserved). Requires workCenter:write.
upsertWorkspaceWorkspacePayload!input: UpsertWorkspaceInput!Create a workspace or overwrite its open draft. PERSONAL is self-service; TEAM/INSTANCE require workspace:write.
validateIntegrationDraftIntegrationValidationResult!input: ValidateIntegrationDraftInput!Validate a draft without publishing. Requires integrationDefinition:write permission.
validateJinjaValidateJinjaResult!input: ValidateJinjaInput!Statically validate a workflow expression (parse + filter-name check) without evaluating it. Safe to call from editors on every keystroke.
validateJourneyDefinitionValidateSurfacePayload!definition: String!Validate a journey definition through the full two-tier pipeline (Tier-1 SurfaceKit + Tier-2 live-schema GraphQL) WITHOUT persisting it. Returns the full diagnostic list. Requires journey:write. Returns success:false with an explanatory diagnostic when the live schema is unavailable — unlike write mutations, this mutation never silently skips Tier-2.
validateLuaValidateLuaResult!input: ValidateLuaInput!Type-check Lua source against the ambient typedef for the chosen role without persisting anything. Safe to call from editors on every keystroke.
validateLuaScriptValidateScriptPayload!script: String!Validate a Lua script for syntax errors. Requires script:execute permission.
validateTemplateValidateTemplatePayload!input: ValidateTemplateInput!Validate template syntax without saving. Requires template:read permission.
validateWorkflowValidateWorkflowPayload!input: ValidateWorkflowInput!Validate a workflow definition without importing it. Requires workflow:read permission.
validateWorkspaceDefinitionValidateSurfacePayload!definition: String!Validate a workspace definition through the full two-tier pipeline (Tier-1 SurfaceKit + Tier-2 live-schema GraphQL) WITHOUT persisting it. Returns the full diagnostic list. Requires workspace:write. Returns success:false with an explanatory diagnostic when the live schema is unavailable — unlike write mutations, this mutation never silently skips Tier-2.

Relationships ​

Connect machines, automate workflows, and build custom apps for print production.