# Print Prepress Substrates, imposition specs, preflight reports, prepress operations and artwork files. ## Operations ```graphql # Print Prepress (print-prepress) # Substrates, imposition specs, preflight reports, prepress operations and artwork files. # Print-specific. Product templates are here because instantiation is a prepress concern. # Query compileSchemaXML: String! # Compile standalone XML schema syntax into JSON Schema without persisting it; host restrictions apply when embedded extractProduction: ExtractProductionPayload! # Extract ISO 19593-1 production steps from supplied PDF bytes inline (not persisted) — inspect before creating Operations folder: Folder # A single folder in the caller's tenant, or null when no folder with that id exists there folders: FolderConnection! # Folders in the caller's tenant, filtered and sorted, as a connection generateDefaultDataQuery: String # Generate a default GraphQL data query for an event topic getComponentArtworkFile: ComponentArtworkFileState # Fetch a component artwork file reference by ID getDropboxBackend: DropboxBackend # Fetch one storage backend as a Dropbox backend getFTPBackend: FTPBackend # Fetch one storage backend as an FTP backend getFile: FileState # Fetch a file by ID getGoogleDriveBackend: GoogleDriveBackend # Fetch one storage backend as a Google Drive backend getHostPathBackend: HostPathBackend # Fetch one storage backend as a host-path backend getImpositionSpec: ImpositionSpecState # Fetch an imposition spec by ID getMagicQueryGraphQL: MagicQueryOperation! # Resolves a Magic Query string to the real GraphQL operation and variables it runs, so consumers can graduate from the façade to raw GraphQL getMagicQuerySchema: MagicQuerySchema! # Returns the input JSON Schema and output introspection for a Magic Query noun, so consumers (especially LLMs) can learn its contract before calling magicQuery getPreflightReport: PreflightReportState # Fetch a preflight report by ID getPrepressOperation: PrepressOperationState # Fetch a prepress operation by ID getProductTemplate: ProductTemplateState # Fetch a product template by ID getProductTemplateVersion: ProductTemplateVersionState # Fetch a specific published version getS3Backend: S3Backend # Fetch one storage backend as an S3 backend getStorageBackend: StorageBackendOutput # Fetch one storage backend by id getSubstrate: SubstrateState # Fetch a substrate by ID getSubstrateBy: SubstrateState # Fetch a substrate by external ID getSubstrateTemplateLine: SubstrateTemplateLineState # Fetch a single substrate template line by ID helpChapter: HelpChapter # Read a chapter of the current published manual edition helpChapters: [HelpChapterInfo!]! # List human-facing manual chapters from the running deployment iacGuides: [IaCGuide!]! # Every authoring guide, for a tool that syncs them to a folder iacSchema: IaCSchemaDocument! # The infrastructure-only view of this schema, for declarative tooling iacSchemaDocument: IaCSchemaDocumentPayload! # Fetch the JSON Schema document a SCHEMA-kind validator references, for declarative tooling iacValidate: IaCValidationResult! # Validate an infrastructure artifact listComponentArtworkFiles: [ComponentArtworkFileState!]! # List artwork file references for a component listDataChangeEventTopics: [DataChangeEventGroup!]! # List all valid data change event topics, grouped by resource listFiles: FileConnection! # List files with pagination and filtering listFoldPatterns: FoldCatalogPayload! # List all available fold patterns from the catalog listImpositionSpecs: [ImpositionSpecState!]! # List imposition specs for a component listMagicQueries: [MagicQueryInfo!]! # Lists every available Magic Query noun with a short description and its options — the discovery entry point listPreflightReports: [PreflightReportState!]! # List preflight reports for a component listPrepressOperations: [PrepressOperationState!]! # List prepress operations for a component listProductTemplateVersions: ProductTemplateVersionConnection! # List published versions of a template with pagination listProductTemplates: ProductTemplateConnection! # List product templates with optional filters, sorted by name listStorageBackends: StorageBackendConnection! # List the calling tenant's storage backends listSubstrateTemplateLines: [SubstrateTemplateLineState!]! # List substrate template lines for a product template listSubstrates: SubstrateConnection! # List substrates with pagination and filtering magicQuery: JSON! # Executes a Magic Query string and returns the predefined query's JSON result ping: String! # Health check endpoint preflightCheck: PreflightCheckPayload! # Run preflight on supplied PDF bytes inline (not persisted) previewImposition: PreviewImpositionPayload! # Preview imposition layout without creating records renderArtworkPreview: RenderArtworkPreviewPayload! # Render a page of an artwork file to a JPEG preview (base64) renderPlateSeparation: RenderArtworkPreviewPayload! # Render a single ink separation (plate) of an artwork page to a grayscale PNG (base64) renderPreview: RenderArtworkPreviewPayload! # Render a page of supplied PDF bytes to a JPEG preview (base64) inline renderSchemaXML: String! # Render JSON Schema as native XML without dropping unsupported keywords or changing a saved document renderSeparation: RenderArtworkPreviewPayload! # Render a single ink separation (plate) from supplied PDF bytes to a grayscale PNG (base64) inline schemaAuthoringCatalog: JSON! # Compiler-owned vocabulary for the standalone XML JSON Schema dialect, including native form annotations searchHelp: HelpSearchResult! # Search human-facing manuals using shared semantic and text retrieval storageCapabilities: StorageCapabilitiesOutput! # Which storage backend kinds this deployment supports, so a client can hide unusable options # Mutation calculateImposition: CalculateImpositionPayload! # Calculate imposition layout for a component and create ImpositionSpec records completeFileUploads: CompleteFileUploadsPayload! # Mark one or more uploads as ready consolidateImpositionFinishing: ConsolidateFinishingPayload! # Derive the consolidated per-kind finishing (cut-file) view from an imposed plan's per-cell finishing createFile: UpsertFilePayload! # Create an external-backed file createFolder: FolderPayload! # Creates a folder in the caller's tenant createProductTemplate: UpsertProductTemplatePayload! # Create a new product template createStorageBackend: UpsertStorageBackendPayload! # Create a new storage backend createStorageBackendAuthorization: CreateStorageBackendAuthorizationPayload! # Start the OAuth consent flow for a Google Drive or Dropbox backend createSubstrate: UpsertSubstratePayload! # Create a new substrate, failing if the code is already taken createSubstrateTemplateLine: UpsertSubstrateTemplateLinePayload! # Create a new substrate template line deleteComponentArtworkFile: DeleteComponentArtworkFilePayload! # Remove an artwork file reference from a component deleteFile: DeletePayload! # Delete a file deleteFolder: DeletePayload! # Deletes a folder deleteImpositionSpec: DeleteImpositionSpecPayload! # Remove an imposition spec from a component deletePreflightReport: DeletePreflightReportPayload! # Delete a preflight report deletePrepressOperation: DeletePrepressOperationPayload! # Delete a prepress operation deleteProductTemplate: DeleteProductTemplatePayload! # Delete a product template deleteStorageBackend: DeletePayload! # Delete a storage backend deleteSubstrate: DeletePayload! # Delete a substrate deleteSubstrateTemplateLine: DeletePayload! # Delete a substrate template line extractProductionOperations: ExtractProductionOperationsPayload! # Extract ISO 19593-1 production steps from an artwork file and derive Operations (optionally persisting them) fileDownloadUrl: FileDownloadGrant! # Resolve a download URL imposePdfInline: ImposePdfInlinePayload! # Compose real source PDF pages using a previously calculated signature plan installCanonicalTemplate: UpsertProductTemplatePayload! # Install a canonical product template (shipped with the app) into the calling tenant as a fresh draft instantiateProductTemplate: InstantiateProductTemplatePayload! # Instantiate a published product template into a print job publishProductTemplate: PublishProductTemplatePayload! # Publish a product template version renderImpositionSVG: RenderImpositionSVGPayload! # Render an imposition layout as SVG requestFileUploads: RequestFileUploadsPayload! # Allocate one or more cloud upload URLs runPreflight: RunPreflightPayload! # Run the PrepressKit preflight engine on an artwork file and persist the report testFolder: FolderProbeResult! # Checks a folder transport with a read-only stat probe testStorageBackend: StorageBackendProbeResult! # Probe a storage backend's connectivity with its stored credentials (a bucket/root head — nothing is written) updateFile: UpsertFilePayload! # Update a file updateFolder: FolderPayload! # Patches a folder updateImposingSettings: UpdateImposingSettingsPayload! # Saves the imposing section updatePaperWeightSettings: UpdatePaperWeightSettingsPayload! # Saves the paper weight section updateProductTemplate: UpsertProductTemplatePayload! # Update a product template updateStorageBackend: UpsertStorageBackendPayload! # Update a storage backend updateSubstrate: UpsertSubstratePayload! # Update a substrate in place updateSubstrateTemplateLine: UpsertSubstrateTemplateLinePayload! # Update a substrate template line in place upsertComponentArtworkFile: UpsertComponentArtworkFilePayload! # Add or update an artwork file reference on a component upsertFile: UpsertFilePayload! # Create or update an external-backed file upsertImpositionSpec: UpsertImpositionSpecPayload! # Add or update an imposition spec on a component upsertPreflightReport: UpsertPreflightReportPayload! # Create or update a preflight report on a component upsertPrepressOperation: UpsertPrepressOperationPayload! # Create or update a prepress operation on a component upsertProductTemplate: UpsertProductTemplatePayload! # Create or update a product template upsertStorageBackend: UpsertStorageBackendPayload! # Create or update a storage backend in one call upsertSubstrate: UpsertSubstratePayload! # Create or update a substrate upsertSubstrateTemplateLine: UpsertSubstrateTemplateLinePayload! # Create or update a substrate template line # Subscription dataChangeEvents: DataChangeEvent! # Subscribe to real-time data change events # Call describe_operation(name) for arguments and input types. ``` ## Exact schema Download [complete SDL](/schemas/print-prepress.graphql) (333084 bytes). Use the SDL to validate operations; the digest omits argument signatures. ## Guides - [Choose configured folders and storage](/docs/data-model/prepress#choose-configured-folders-and-storage) - [Receive and organise production files](/docs/data-model/prepress#receive-and-organise-production-files) - [Connect artwork to the component](/docs/data-model/prepress#connect-artwork-to-the-component) - [Check artwork and inspect separations](/docs/data-model/prepress#check-artwork-and-inspect-separations) - [Prepare imposition and production output](/docs/data-model/prepress#prepare-imposition-and-production-output) - [Run configured prepress workflows](/docs/data-model/prepress#run-configured-prepress-workflows) - [Prepress API reference](/docs/data-model/prepress-reference) - [Manage reusable automation through IaC](/docs/data-model/prepress#manage-reusable-automation-through-iac)