Signature
get_files({ file_id?, query?, offset?, limit? })Call with {} to list the most recent files and storage usage. query searches filenames and the names of the tools that generated files, limit defaults to 25 (maximum 100), and offset pages through results. Supply a UUID file_id to retrieve one file, including a pending human upload.
The response includes files, total, offset, limit, and storage (used_bytes, reserved_bytes, limit_bytes, available_bytes). Lists include each file's stable id, stored name, display_name, download_name, type, size, source and optional run_id. Generated files are named after their tool and run time, such as Seedance 2.5 Portrait-to-Video · 6 Oct 00:15, and include run_details with the tool, agent, run charge and time zone. Uploaded files keep their uploaded name. Supply file_id to receive a ready file's fresh signed url, download_url and url_expires_at; download_url saves the file as download_name.
Use the ready file's URL in a catalog tool's existing reference URL input. URL expiry does not delete the file: call get_files with that file_id again. Ordinary files remain until deleted or their workspace closes. Connected Google content keeps its shorter retention.
For an upload_file handoff, poll its file ID until status is ready. awaiting_upload means the human has not chosen a file; pending means upload or generation is unfinished. Do not start a reference-dependent run until it is ready.
CLI: scrollport get_files [file-id] [--query reference] [--offset 25]. HTTP: GET /v1/files with the same query fields. Free and read-only; workspace file access is required. Files from another workspace return the same not-found response as missing files.