Printago API

Getting Started

Introduction Authentication Errors QR Tag Link Format Realtime MQTT Camera Streaming Webhooks Querying Data Uploading Files Versioning OpenAPI Spec Best Practices

API Keys

GET Get all API keys GET Get API key by ID GET Get API key permissions GET Get API key roles POST Create an API key POST Search API keys PATCH Update an API key DEL Delete an API key

Audit Logs

GET List audit logs POST Search audit logs

Cards

GET Get all dashboard cards GET Get dashboard card by ID POST Create dashboard card POST Search dashboard cards PATCH Update dashboard card DEL Delete dashboard card

Classwork

GET Get a classwork item GET Get a download URL for a classwork attachment GET List classwork items GET List students eligible for classwork assignment GET List the parts referenced by a classwork item GET List the students assigned to a classwork item POST Add a link to a classwork item POST Bulk-delete classwork items POST Commit an uploaded classwork attachment POST Create a classwork item POST Get a signed upload URL for a classwork attachment POST Reference a part from a classwork item POST Search classwork items POST Which classwork items reference these parts PUT Set the students assigned to a classwork item PATCH Update a classwork attachment (reorder) PATCH Update a classwork item PATCH Update a classwork link PATCH Update a classwork part reference DEL Delete a classwork item DEL Remove a classwork attachment DEL Remove a classwork link DEL Remove a classwork part reference

Cloud

GET Get sync status for a cloud-storage integration GET List all file sync records for a cloud-storage integration GET List connected accounts for a cloud-storage provider GET List folders in a cloud-storage account for folder selection POST Disconnect a cloud-storage integration POST Enqueue a background sync for a cloud-storage integration (returns immediately) POST Re-import a file whose part was deleted inside Printago POST Select the folder to watch for a cloud-storage integration PATCH Update sync settings for a cloud-storage integration

Cost Catalog

GET Get all cost components GET Get cost component by ID POST Create new cost component POST Search cost components PATCH Update cost component DEL Delete cost component

Custom Fields

GET Custom field usage across the store GET Get a custom field definition by ID GET List custom field definitions GET Preview typing a custom field POST Define a custom field POST Search custom field definitions PUT Replace custom field values on a record PUT Replace custom field values on many records PATCH Merge custom field values into a record PATCH Merge custom field values into many records PATCH Update a custom field definition DEL Remove a custom field definition

Customers

GET Get all customers POST Search customers

Customizer

GET Get customizer config GET Get customizer design GET Get customizer Shopify publication state GET Get design SVG GET Get design with per-layer files GET List custom fonts GET List customizer configs GET List customizer designs GET List Google Fonts catalog GET List store custom textures GET List store Google fonts pool POST Add example customizer config POST Add Google font to store pool POST Create customizer config POST Get colors for SKUs POST Preview customizer build overlay POST Publish customizer config to Shopify POST Simulate a customer order for a customizer design POST Upload background SVG POST Upload custom font POST Upload store custom texture PATCH Update customizer config PATCH Update store custom texture DEL Delete background SVG DEL Delete custom font DEL Delete customizer config DEL Delete store custom texture DEL Remove Google font from store pool DEL Unpublish customizer config from Shopify

Default

GET GET /v1/fuse/store-settings PATCH PATCH /v1/fuse/clients/{clientId}

eBay

GET Get eBay settings GET Get eBay status GET List eBay integrations POST Create eBay shipping fulfillment POST Sync eBay orders PATCH Update eBay settings

Entitlements

GET Check if store has specific entitlement GET Get all entitlements GET Get entitlement by ID POST Search entitlements

Etsy

GET Get Etsy listing GET Get Etsy settings GET Get Etsy status GET Get Etsy usage stats GET List Etsy integrations POST Sync Etsy orders PATCH Update Etsy settings

Filament Stock

GET Get filament stock GET Get stock activity GET Get tracked spools GET List recent suppliers POST Adjust bulk stock POST Convert bulk to spools POST Receive filament

Files

GET Get a library file GET Get all library files GET List Google Fonts families POST Add a file to the library POST Add a Google Fonts family POST Get signed download URLs POST Get signed upload URLs POST Search library files DEL Delete a library file

Folders

GET Get all folders GET Get folder by ID GET Get folders by type GET Get part folders GET Get SKU folders POST Create a new folder POST Search folders PATCH Move folders to a new parent PATCH Rename a folder DEL Delete folders

Hints

GET Get path schema GET Get type schema GET List available paths GET List available types

Integrations

GET Get a specific integration by ID GET Get all integrations POST Search integrations

Layouts

GET Get all dashboard layouts GET Get dashboard layout by ID POST Create dashboard layout POST Search dashboard layouts PATCH Update dashboard layout DEL Delete dashboard layout

Linked Parts

GET Get a specific linked part by ID GET Get all linked parts for a store POST Create a new linked part POST Search linked parts PATCH Update a linked part DEL Delete a linked part

Macros

GET Get all GCODE macros GET Get GCODE macro by ID GET List printer models for macro compatibility POST Create GCODE macro POST Run GCODE macro on printers POST Search GCODE macros PATCH Update GCODE macro DEL Delete GCODE macro

Maintenance

GET Get completion history GET Get fleet maintenance status GET Get printer maintenance status GET Get recommended maintenance profiles GET List enrollments GET List maintenance items POST Create maintenance item POST Duplicate maintenance item POST Enroll printers POST Enroll recommended maintenance POST Mark maintenance done PATCH Set maintenance mode PATCH Update maintenance item DEL Delete maintenance item DEL Unenroll printers

Materials

GET Get all material profile assignments GET Get all materials GET Get billable rates GET Get full material data GET Get material by ID GET Get material pricing GET Get material stock activity GET Get spool received dates POST Assign profile to material POST Copy material profiles POST Create material POST End billable rates POST Search material profile assignments POST Search materials POST Set billable rates PATCH Update a billable rate PATCH Update material DEL Clear material profile DEL Delete a billable rate DEL Delete material DEL Delete materials

Material Assignments

GET Get all assignments GET Get assignment by ID GET Get part assignments POST Assign material to part DEL Clear part assignments DEL Remove assignments

Material Groups

GET Get all group members GET Get all groups GET Get all material group members GET Get all material groups GET Get group by ID GET Get group member by ID GET Get group members POST Add group member POST Create group POST Search material group members POST Search material groups PATCH Update group DEL Delete group DEL Delete multiple groups DEL Remove group members

Material Instances

GET Get a spool serial GET Get all material instances GET Get instance by ID GET Get spool activity POST Add a spool serial to inventory POST Create material instance POST Finish spools POST Restore spools PUT Update material instance DEL Delete material instance

Material Variants

GET Get all material variants GET Get all variants GET Get variant by ID GET Get variants by material POST Assign profile to variant POST Batch create variants POST Create variant POST Search material variants PATCH Update variant DEL Clear variant profile DEL Delete multiple variants DEL Delete variant

Notifications

GET Get notification channel GET List Discord category routes GET List Discord mentions GET List notification channels POST Add a Discord mention POST Enable a notification channel POST Send a test message for a category PUT Set a Discord category route PATCH Configure channel events PATCH Disable a notification channel DEL Delete a Discord category route DEL Delete a Discord mention

Orders

GET Get all customers GET Get all ignored SKUs GET Get all orders GET Get complete order data GET Get customer by ID GET Get ignored SKUs list GET Get order with full details GET Get order without related data GET Get print jobs for an external order POST Cancel an order POST Check if SKUs are ignored POST Create a new customer POST Create a new order POST Reconcile print jobs with orders POST Reconcile print jobs with orders POST Search ignored SKUs POST Search orders PUT Update an order PATCH Batch cancel orders PATCH Batch close orders PATCH Batch reopen orders PATCH Update ignored SKUs list DEL Batch delete orders DEL Delete an order

Order Items

GET Get a specific order item GET Get all order items GET Get all order items GET Get items for a specific order POST Add items to an order POST Search order items PUT Update an order item PATCH Batch update order items DEL Delete an order item

Parts

GET Get a part's pre-slice results GET Get all part material assignments GET Get all parts GET Get part by ID GET Get part metadata POST Create a new part POST Create SKUs from parts POST Extract 3MF metadata from a staged upload POST Get part footprint hulls POST Reprocess a part POST Retry failed part processing POST Search part material assignments POST Search parts POST Split multi-plate 3MF file POST Trigger part estimation PATCH Bulk update parts PATCH Set text placeholder sizing PATCH Update a part DEL Delete a part DEL Delete multiple parts

Part Builds

GET Get a specific part build by ID GET Get a specific part build step by ID GET Get all part build steps GET Get all part builds for a store POST Search part build steps POST Search part builds PATCH Archive part builds PATCH Dismiss part builds (deprecated) PATCH Restore archived part builds

Permissions

GET Get all permissions GET List permission types POST Search permissions

Print History

GET List a printer's print history GET List print history GET List print history GET Trace a spool serial through print history POST Search print history

Print Jobs

GET Get all print jobs GET Get all-time completed job count GET Get job matching details GET Get job matching troubleshooting details GET Get print job GET Get print job telemetry GET Get raw telemetry download URL GET List archived jobs GET List print job attempts POST Get compatible printers per queue group POST Get print job footprint hulls POST Merge print jobs onto one plate POST Run the queue matcher now POST Search print jobs POST Send job directly to a printer POST Split group POST Un-merge a plate PATCH Acknowledge job start PATCH Adjust group quantity PATCH Bulk reorder jobs PATCH Cancel print jobs PATCH Clear finished jobs PATCH Move jobs to the back of the queue PATCH Pause print jobs PATCH Prioritize jobs PATCH Reorder a job PATCH Reorder group PATCH Resume paused jobs PATCH Retry failed jobs PATCH Update print job

Printers

GET Get all printers GET Get hidden error codes GET Get latest camera snapshot URL GET Get printer by ID GET Get resolved capabilities GET Last printed history GET List AI failure alerts POST Add a printer POST Force refresh printer state POST Get printers' next queue matches POST Resolve capabilities for printers POST Search printers POST Send command to printers PUT Add multiple printers PUT Submit or change feedback on an AI failure alert PATCH Bulk update printers PATCH Confirm printer ready PATCH Multi-update printers PATCH Rename a printer PATCH Set Fabmatic PATCH Set printer enabled status PATCH Set provider config PATCH Update a printer DEL Delete a printer DEL Delete multiple printers

Printer Slots

GET Get all printer slots GET Get all printer slots GET Get printer slot by ID POST Search printer slots PATCH Assign to printer slots PATCH Clear printer slots PATCH Set slot profile DEL Clear all printer slots

Printing

POST Create and queue prints POST Preview part builds and jobs (dry run)

Profiles

GET Get a specific profile GET Get all available printer models GET Get all slicer profiles GET Get available slicer versions GET Get available slicer versions for a profile GET Get full profile data with optional slicer version GET Get printer models used in your store GET Get profile with inheritance details GET Get profiles by machine model and nozzle size GET Get profiles compatible with a printer GET Get supported printer models POST Create a new profile POST Import pre-parsed profiles POST Import profiles from a file POST Preview profiles from a file POST Search profiles PATCH Update a profile DEL Delete a profile DEL Delete multiple profiles

QR Tags

GET Get a QR tag GET List QR tags GET List scan actions POST Create QR tags POST Resolve scanned QR tags POST Run a scanned tag's action PATCH Revoke QR tags PATCH Unbind QR tags

Reports

GET Jobs report GET Materials report GET Printers report GET Profit report GET Reliability report GET Reports overview GET Usage by user report

Sequences

GET Get all sequences with usage GET Get all serial-number sequences GET Get sequence by ID GET List issued serials for a sequence POST Create a sequence POST Search sequences PATCH Update a sequence DEL Delete a sequence

Settings

GET Get available slicer versions GET Get store settings GET Get user settings POST Search notification settings POST Search store settings PATCH Update store settings PATCH Update user settings

Shippo

GET Get Shippo settings GET Get Shippo status GET List Shippo integrations POST Connect Shippo POST Sync Shippo orders POST Test a Shippo connection PUT Replace the Shippo API key PATCH Update Shippo settings

ShipStation

GET Get ShipStation settings GET Get ShipStation status GET List ShipStation integrations GET List ShipStation stores POST Connect ShipStation POST Sync ShipStation orders POST Test a ShipStation connection PATCH Update ShipStation settings PATCH Update ShipStation store selection

Shopify

GET Get Shopify settings GET Get Shopify status GET List Shopify integrations GET List Shopify products POST Disconnect Shopify POST Retry variant enrichment PATCH Update Shopify settings

SKUs

GET Get a specific SKU GET List all SKUs POST Create a new SKU POST Delete multiple SKUs POST Duplicate a SKU POST Search SKUs PATCH Update a SKU DEL Delete a SKU

SKU Builds

GET Get a specific SKU build by ID GET Get all SKU builds for a store POST Search SKU builds

SKU Costs

GET Get a specific SKU cost by ID GET Get all costs for a specific SKU GET Get all SKU costs for a store GET Get cost breakdown for a specific SKU POST Create a new SKU cost POST Search SKU costs PATCH Update a SKU cost DEL Delete a SKU cost DEL Delete all costs for a specific SKU

SKU Variants

GET Get a specific property value by ID GET Get a specific SKU variant by ID GET Get a specific variant binding by ID GET Get a specific variant property by ID GET Get a specific variant value by ID GET Get all property values for a store GET Get all SKU variants for a store GET Get all value filters for a SKU GET Get all variant bindings for a store GET Get all variant properties for a store GET Get all variant values for a store GET Get filtered option values for a SKU GET Get SKU-specific properties GET Get value filters for a SKU and option GET Get variant values for a specific group GET Match a SKU string with variants POST Create a new SKU variant POST Create a new variant binding POST Create a new variant property POST Create a new variant value POST Create multiple property values POST Reorder a variant binding POST Reorder a variant property POST Reorder a variant value POST Search SKU options POST Turn an empty SKU variant into an alias of another variant PUT Set filtered values for a SKU option PATCH Update a SKU variant PATCH Update a variant binding PATCH Update a variant property PATCH Update a variant value PATCH Update multiple property values DEL Delete a SKU variant DEL Delete a variant binding DEL Delete a variant property DEL Delete a variant value DEL Delete multiple property values DEL Remove a value filter

Staggered Start

GET Get Staggered Start group GET List Staggered Start group members GET List Staggered Start groups GET List Staggered Start holds POST Create Staggered Start group POST Release a Staggered Start hold PUT Replace Staggered Start group members PATCH Update Staggered Start group DEL Delete Staggered Start group

Stores

GET Get all stores for current user PATCH Update organization settings

Subscriptions

GET Get addon by type with tiers GET Get addon subscription by type GET Get all addon subscriptions GET Get all available addons GET Get current subscription POST Search addon subscriptions POST Search subscriptions PATCH Configure audit logs

TikTok

GET Get TikTok Shop settings GET Get TikTok Shop status GET List TikTok Shop integrations POST Sync TikTok Shop orders PATCH Update TikTok Shop settings

Users

GET Get role permissions GET Get user details GET Get user permissions GET List roles GET List roles with permissions GET List store users POST Assign a role POST Bulk update users POST Grant permissions POST Invite a user POST Resend an invitation POST Revoke an invitation PUT Set user permissions PUT Set user roles DEL Remove a role DEL Remove a user DEL Revoke permissions

Wix

GET Get Wix settings GET Get Wix status GET List Wix integrations POST Push fulfillments to Wix POST Sync Wix orders PATCH Update Wix settings

WooCommerce

GET Get WooCommerce settings GET Get WooCommerce status GET List WooCommerce integrations POST Sync WooCommerce orders PATCH Update WooCommerce settings

Printago API

DELETE /v1/store-files/{id}

Delete a library file

Requires: file.manage

Path Parameters

id required

string

API Console

Base URL

Authentication

API Key

Store ID

Parameters

Request Body

Response

Send a request to see the response