This page introduces the foundational ideas and patterns that power the platform. Understanding these concepts will help you get the most out of the API and build robust integrations for 3D printing workflows.
Authentication & Security
All API endpoints require authentication using a Bearer JWT token. You generate tokens from your Cloud Slicer dashboard and include them in the Authorization header of every request.
Reminder: Keep your API tokens secure. Never share them publicly or commit them to version control.
API Structure
-
Account Management
Manage your account and uploads through dedicated endpoints:
GET /userRetrieve your account detailsGET /user/uploadsList all of the files you've uploaded to your account. These are listed from newest to oldest.
-
Part Info
Check if your models are printable and get part dimensions:
POST /printability/{file_id}Gets measurements of the uploaded file in order to check that the part will fit in the printer before your generate a quote.
If you are familiar with Three JS, you can calculate this with Javascript on the client side of your web app, bypassing the need to use this endpoint. This is provided as an alternative to give you more options.
-
File Operations
Upload, download, and delete STL files to Cloud Slicer:
- Create Upload ID:
GET /file/upload-id- Get an upload_id to upload a new STL file with thepublic uploadroute. - Public Upload File:
POST /file/public/{upload_id}- This route does NOT require authentication. Use this on your client side to upload the file directly to our storage.Using the
Public Uploadroute lets you avoid having to route large files through your backend server. This route uses the upload_id you generated earlier to securely upload an STL file and prevent any CORS errors with the Cloud Slicer API. - Upload File:
POST /file— Upload a new STL file (this should only be done from the server side to prevent exposing your token, see above) - Download File:
GET /file/{file_id}— Retrieve a file per its file_id - Delete:
DELETE /file/{file_id}— Remove a file you no longer need per its file_id
- Create Upload ID:
-
Quote Operations
Create, retrieve, delete, download quotes for your 3D prints:
- Quote File:
POST /quote/{file_id}- Create an instant quote on an uploaded file given its file_id. Returns a quote_id. - Get Quote Record:
GET /quote/{quote_id}- Retrieve a quote record given its quote_id you received when creating the quote on the/quote/{file_id}route. - Delete Quote:
DELETE /quote/{quote_id}— Delete a quote record along with its G-code file per its quote_id - Download .gcode:
GET /quote/gcode/{quote_id}— Download the generated G-code file for the quote per its quote_id
- Quote File:
Printer & Quote profiles
Generating instant quotes for your 3D prints:
printer_configThis allows you to configure a profile that matches your printer so you can dial in your instant quote accuracy for print time and material usage.quote_configThis allows you to create a custom pricig profile to match your business needs. You can set your own material costs, hourly rates, base cost (think of this as a minumum spend), and your currency.
Slicing & G-code Generation
Each quote request generates G-code for your .stl, .3mf, or .obja file based off of the printer_config you have provided. Using G-code as the source of truth allows you to get the most accurate cost and material usage estimates possible.
RESTful, Versioned API
- All endpoints are versioned (e.g.,
/v1/) - Uses standard HTTP protocols:
GET,POST,DELETE,PUT - Follows OpenAPI standards for schema and documentation