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.

The upload must be a .stl, .obj, .3mf, .amf, or .step/.stp file.

Playground note: in the Body section, open the dropdown and select Multipart. Add an entry with the key file, then click the value field to attach your 3D model (.stl, .obj, .3mf, .amf, or .step/.stp). Without this, the request will send the raw file bytes and the server will return a 422 validation error.

Generate an upload ID for uploading a file to the database.

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.

Playground note: in the Body section, open the dropdown and select Multipart. Add an entry with the key file, then click the value field to attach your 3D model (.stl, .obj, .3mf, .amf, or .step/.stp). Without this, the request will send the raw file bytes and the server will return a 422 validation error.

Download an uploaded file for the authenticated user.

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.