Manifest is in cache with synapse get -q


We are exposing `synapse get -q` to programmatically download data in portals from view queries (here is an example if you click Download Options > Programmatic Options).

I was surprised that when I tested this, the manifest was hidden in my Synapse cache and not the working directory.

When I test this with `synapse get` on a file. There is no manifest downloaded.

I thought I remembered this command downloads a manifest every time, automatically. What is the expected behavior with the manifest?

I'm testing this feature in the context of


Synapse Client 2.0.0


Kelsey Montgomery
August 13, 2020, 9:26 PM

Good point about not conflating “manifest”. I think SYNAPSE_TABLE_QUERY_[file_handle_id].csv is suitable.

Jordan Kiang
August 20, 2020, 12:29 AM

This is resolved and will be included in the next RC release.

A SYNAPSE_TABLE_QUERY_[file_handle_id].csv file will be downloaded to specified downloadLocation (defaults to the current working directory in the command line client).

Kelsey Montgomery
August 20, 2020, 7:02 PM

code looks good!

Kelsey Montgomery
August 25, 2020, 6:49 PM

The choice to create a name distinct from manifest is to distinguish the functional differences between a manifest and table query. In discussing with “It is currently more than just a distinction in the name, the table query produces a csv, manifests are tsv files, the columns of a tsv are proscribed (must have a path and a parent column, provenance columns and some other columns have special meanings, other columns are loose annotations etc). Whereas the table query file can have special row columns that aren't relevant to a "manifest" etc and depending on what the user entered as the query could include a lot of columns that are not interpretable as a manifest. they're just separate formats.”

Kelsey Montgomery
August 31, 2020, 4:17 PM

Tested release candidate for version 2.2.0 and can confirm SYNAPSE_TABLE_QUERY_###.csv is in the working directory as expected.



Jordan Kiang


Kelsey Montgomery




Kelsey Montgomery

Development Area


Release Version History


Fix versions