Welcome to the Cloud Slicer's BETA Documentation! 🧪

Documentation
API Docs

Creating Quotes

Troubleshooting

API Playgroundnew Swagger Docs (Legacy)

powered by Zudoku

Guides

Managing Files

This guide covers the file lifecycle: how you upload a 3D model, find files you've uploaded before, pull one back down, or delete it. Every request needs your API token from the Quick Start in the Authorization: Bearer ... header.

Supported formats

You can upload .stl, .obj, .3mf, .amf, .step, and .stp files, up to 200 MB each. Filenames cannot contain \ / { } ^ % [ ] " < > ~ # | & $ @ = ; : + ? , ' ( ) !.

Upload a file

POST /v1/file accepts a single multipart/form-data field named file. The response gives you the file_id you'll plug into every quote request.

You get back { file_id, file_name, file_path, file_size, status, timestamp, user_id }. Hold onto file_id — it's required to create a quote.

List your files

GET /v1/file returns every file you've uploaded, newest first.

Each record has the same fields as the upload response, plus an id for the upload record itself.

Download a file

GET /v1/file/{file_id} streams the original binary back. Write it to disk or pipe it wherever you need it.

Delete a file

DELETE /v1/file/{file_id} removes the file from storage.

Deleting a file cascades — any quotes generated from it are deleted too. There's no undo.

Advanced: pre-signed upload links

When you can't (or don't want to) ship your API token to the uploader — for example, a browser drag-and-drop — generate a one-time upload session instead. GET /v1/file/upload-id returns an upload_id good for one hour. The uploader then POSTs the file to /v1/file/public/{upload_id} with no auth header.

This is the same two-step flow the Cloud Slicer quote widget uses to accept uploads from anonymous visitors on your site.

Once you have a file_id, head to Creating Quotes.

Last modified on June 23, 2026

Authentication Managing Files

On this page

Supported formats
Upload a file
List your files
Download a file
Delete a file
Advanced: pre-signed upload links

import requests

API_TOKEN = "YOUR_API_TOKEN"
BASE_URL = "https://api.cloudslicer3d.com/v1"

with open("3dbenchy.stl", "rb") as f:
    response = requests.post(
        f"{BASE_URL}/file",
        headers={"Authorization": f"Bearer {API_TOKEN}"},
        files={"file": f},
    )

response.raise_for_status()
result = response.json()
print(result["file_id"])

import requests

response = requests.get(
    "https://api.cloudslicer3d.com/v1/file",
    headers={"Authorization": f"Bearer {API_TOKEN}"},
)
response.raise_for_status()

for record in response.json():
    print(record["file_id"], record["file_name"], record["file_size"], "MB")

import requests

file_id = "YOUR_FILE_ID"
response = requests.get(
    f"https://api.cloudslicer3d.com/v1/file/{file_id}",
    headers={"Authorization": f"Bearer {API_TOKEN}"},
    stream=True,
)
response.raise_for_status()

with open("downloaded.stl", "wb") as out:
    for chunk in response.iter_content(chunk_size=8192):
        out.write(chunk)

import requests

file_id = "YOUR_FILE_ID"
response = requests.delete(
    f"https://api.cloudslicer3d.com/v1/file/{file_id}",
    headers={"Authorization": f"Bearer {API_TOKEN}"},
)
response.raise_for_status()
print(response.json()["removed_file_path"])

import requests

# Step 1: get an upload session (server-side, authenticated)
session = requests.get(
    "https://api.cloudslicer3d.com/v1/file/upload-id",
    headers={"Authorization": f"Bearer {API_TOKEN}"},
).json()
upload_id = session["upload_id"]

# Step 2: anyone with that upload_id can upload (no token required)
with open("3dbenchy.stl", "rb") as f:
    result = requests.post(
        f"https://api.cloudslicer3d.com/v1/file/public/{upload_id}",
        files={"file": f},
    ).json()

print(result["file_id"])