MerginMaps / MerginMaps/python-api-client
Add API call to download one file
@varmar05 is already working on this.
Since Aug 10, 2026.
- Dominant language
- Python
- Stars
- 23
- Forks
- 12
- Avg merge
- 2d 13h
- Merged PRs (30d)
- 7
Description
Currently, there's no simple way to fetch just one file from a project. There is download_file() API call, but it needs the project to be already downloaded (it is useful just to get older versions of a file).
One could either query MM server API directly, e.g.:
https://app.merginmaps.com/v1/project/raw/<workspace>/<project>?file=myfile.gpkg
(with appropriate auth token)
Alternatively, using python with a workaround like this (handles auth stuff):
from mergin import MerginClient
from mergin.utils import save_to_file
mergin_client = MerginClient(...)
res = mergin_client.get('/v1/project/raw/<workspace>/<project>', data={'file': 'myfile.gpkg'})
save_to_file(res, 'myfile.gpkg')
If we add support for this, maybe we could just update the existing download_file() implementation so that it will accept as the first argument either <workspace>/<project> or it would accept an existing the local directory with a project downloaded already.
No project checkout, download raw file
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.