Skip to main content

File Browser


page provides access to all of the files uploaded to Ganymede and all files created in Ganymede by Flow Runs for the current environment. Files can be browsed and searched for using various metadata fields, including file name, file type, file size, tags, creation date, file origin and Flows that the file was used in.


Finding files

To search for a file by name, type a query in the search box in the upper left of the page. To filter files by other properties, click the filter icon ( ) next to supported column titles in the table header, select the desired values, and click OK.

Files (filtered)

The advanced search panel allows you to filter files by various file characteristics or file tags. To use this feature, define tag types on the Manage Tag Types panel, and assign tags to specific files using methods found in the file_tags module of the Ganymede SDK.

Advanced Search

Searches are evaluated with an AND condition between the different fields and an OR condition within the same field. For example, if you search for files with the instrument tag "LC" and the tag "MS", the search will return files with either a "LC" or "MS" instrument tag (or both). If you add a size filter of "greater than 1MB", then only files that have either a "LC" or "MS" instrument tag or both and are greater than 1MB will be returned.

Downloading files

To download a file, click the file's name in the File name column.

Linking to files

Click the link icon ( ) next to a file's name in the File name column to copy a link to that file to the clipboard. This link can be shared with other users in the same Ganymede environment. Visiting the link will open the

page filtered to show only the linked file.

Files (copying link)   Files (single-file view)

URLs for files can be generated using the get_file_url function in the Ganymede SDK by calling the get_file_url function.

from import get_file_url

bucket = 'input' # or 'output'
filename = 'sample_file_name.txt'
file_url = get_file_url(filename=filename, bucket=bucket)

This function returns a URL that users can use to directly access the file from another application, such as another LIMS system.


Accessing a Ganymede file URL requires the user to be authenticated in Ganymede. If you're having trouble accessing a file URL, log in to your Ganymede tenant in a separate browser tab and try again.

For each file, the

page shows the ID of the Flow or Agent that originated the file (Origin) along with the IDs of all Flows and Flow Runs that the file was used in (Usage), as applicable. Click any Flow ID, Agent ID or Flow Run ID to view details for that entity in the
Flow View
, and
Flow Runs
pages, respectively.

Files (usage)  


The "Last refreshed" timestamp in the lower left of the page shows the last time the file browser retrieved an up-to-date list of files from Ganymede storage. Click the

button in the lower left of the page to check for files that have been added since the last retrieval.