File

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.

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.

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:

1. Call this endpoint to get an upload_id
2. Use the upload_id with POST /file/public/{upload_id} to upload the file

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.

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.

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.