Quickstart Guide 🚀

Create Your Account

1. Visit www.cloudslicer3d.com to sign up for a new account
2. Fill out the registration form with your details
3. Check your email and click the confirmation link to fully activate your account

Generate Your API Token

1. Log into your Cloud Slicer account
2. Navigate to the dashboard - you'll be redirected here automatically after login
3. Click on the Tokens tab in the left sidebar
4. Create a new token by clicking the New Token button
5. Configure your token:

• Give it a descriptive name (e.g., "My First Token")
• Set the expiration in days OR leave blank for no expiration

6. Copy the generated token immediately and store it securely

Create a Printer Config

1. Click on the Printers tab in the left sidebar
2. Click the + icon in the top right corner
3. Configure your printer settings to match what you currently have in your local slicer application
4. Save the printer configuration

Create a Filament Config

1. Click on the Filaments tab in the left sidebar
2. Click the + icon in the top right corner
3. Configure your filament profile to match what you will use for printing
4. Save the filament configuration

Authenticate with the API

1. Navigate to the API playground at docs.cloudslicer3d.com/api
2. Click the lock icon in the top right corner
3. Paste your JWT token from Step 2 into the authorization field
4. Click Authorize

You're now authenticated and ready to explore the Cloud Slicer API.

Make Your First Set of API Calls

Upload your first STL file:

1. Find the POST /v1/file endpoint in the API documentation
2. Expand the tab to reveal the POST request details
3. Upload an STL file using the choose file button to open up your file explorer
4. Execute the request
5. Copy the file_id from the response

Queue your first quote:

Slicing can take anywhere from a few seconds to over a minute, so quotes are async. You queue a job, then poll until it's ready.

1. Find the POST /v1/quote/queue/{file_id} endpoint in the API documentation
2. Expand the tab to reveal the POST request details
3. Add Details:
   • Fill in the path parameter with the file_id from the previous upload step
   • Fill in both the printer_id and filament_id fields in the request body with the IDs created in Steps 3 and 4
   • Optionally tweak the pricing_config and print_settings — both fall back to sensible defaults if omitted

4. Execute the request — you'll get back a 202 Accepted with a quote_id
5. Copy the quote_id from the response

Poll until it's ready:

1. Find the GET /v1/quote/{quote_id} endpoint
2. Paste the quote_id into the path parameter and Execute
3. Re-run every couple of seconds — status starts at "pending" and ends at "success" or "failed"
4. Once status is "success", the response includes pricing, time, and files.gcode_path — download the g-code with GET /v1/quote/gcode/{quote_id}

You will now see activity in your dashboard since you have uploaded a file and generated a quote