Operations for uploading and managing .stl, .obj, .3mf, .amf, and .step files. Requires Cloud Slicer Token
Get User Files
Get uploaded files for the authenticated user, sorted by latest first. Pass an optional file_id query parameter to fetch metadata for a single file (returns a list of 0 or 1 items). Requires a valid API token.
Required permissions: files:read
query Parameters
file_idOptional file ID. When provided, returns only the matching upload record for the authenticated user.
Optional file ID. When provided, returns only the matching upload record for the authenticated user.
Get User Files › Responses
Successfully retrieved user files
user_idfile_idfile_pathstatustimestampfile_namefile_sizeUpload File
Upload a file to the database for the authenticated user.
Requires a valid API token in the Authorization header (Bearer scheme). You can generate a token from the Cloud Slicer website in your account settings. The upload must be a .stl, .obj, .3mf, .amf, or .step/.stp file. Returns details about the uploaded file, including its ID and storage path.
Required permissions: files:write
Upload File › Responses
File uploaded successfully
user_idfile_idfile_pathstatustimestampfile_namefile_sizeGet Upload Id
Generate an upload ID for uploading a file to the database.
Requires a valid API token in the Authorization header (Bearer scheme). Returns an upload id that can be used with the /file/public/{upload_id} endpoint to upload files without authentication. The upload id expires after 1 hour.
Workflow:
- Call this endpoint to get an upload_id
- Use the upload_id with POST /file/public/{upload_id} to upload the file
Required permissions: files:write
Get Upload Id › Responses
Successfully generated upload ID
user_idupload_idfile_idtimestampUpload File Public
Upload a file using a temporary upload ID (no authentication required).
This endpoint allows anonymous uploads using a temporary upload ID obtained from the /upload endpoint. The upload ID is single-use and expires after 1 hour.
path Parameters
upload_idTemporary upload ID obtained from /file/upload-id endpoint
Temporary upload ID obtained from /file/upload-id endpoint
Upload File Public › Responses
File uploaded successfully
user_idfile_idfile_pathstatustimestampfile_namefile_sizeUpload File From Url
Upload a model file by URL: the API downloads it from url and stores it exactly as if it had been uploaded directly.
The URL must be a public https:// link that serves the file itself (a direct download link, not a page about the model). Links to private or internal addresses are refused. The file name is taken from the download, or from the URL; pass file_name if neither has one. The same file types and size limit as a direct upload apply.
Requires a valid API token in the Authorization header (Bearer scheme).
Required permissions: files:write
Upload File From Url › Request Body
urlPublic https:// URL of the model file to download, e.g. a direct download link from Printables, Thingiverse, GitHub, or a shared storage bucket.
Name to store the file under, including its extension (.stl, .obj, .3mf, .amf, .step/.stp). Only needed when the URL doesn't reveal it.
Upload File From Url › Responses
File downloaded from the URL and stored
user_idfile_idfile_pathstatustimestampfile_namefile_sizeDownload File
Download an uploaded file for the authenticated user.
Requires a valid API token in the Authorization header (Bearer scheme). You can generate a token from the Cloud Slicer website in your account settings. Accepts the file ID as a query parameter. Returns the file as a download if the user is authorized and the file exists.
Required permissions: files:read
path Parameters
file_idID for the STL file to download
ID for the STL file to download
Download File › Responses
File downloaded successfully
Delete File
Deletes an uploaded file and its associated gcode from storage. The quote record is
kept — its file_path and gcode_path are cleared (set to null) rather than deleted,
so quote and order history is preserved.
Requires a valid API token in the Authorization header (Bearer scheme). You can generate a token from the Cloud Slicer website in your account settings. Accepts the file ID as a query parameter. Returns a deleted message and the path of the removed file if deletion is successful.
Required permissions: files:delete
path Parameters
file_idID for the STL file to delete
ID for the STL file to delete
Delete File › Responses
File deleted successfully
user_idstatustimestampfile_idremoved_file_path