---
title: "Download a file"
method: GET
path: "/system/file-explorer/download"
tags: ["System"]
---

# Download a file

`GET /system/file-explorer/download`

## Request

- Base URL: `https://sylve.lan:8181/api`
- URL: `https://sylve.lan:8181/api/system/file-explorer/download`
- Auth: API key in header `Authorization`

Stream a regular file from an absolute system path with HTTP range support

## Query parameters

- `id` string, required
- `hash` string
- `auth` string

## Response `200`

File content

## Other responses

- `206`: Partial file content
- `400`: Invalid path or non-regular file
- `401`: Unauthorized
- `403`: Administrator access or filesystem permission required
- `404`: File not found
- `416`: Range Not Satisfiable
- `500`: Unexpected filesystem failure

## Changes

- **2026-08-12** `9a5026bf9057`: 7 info
  - added the new optional `query` request parameter `auth`
  - added the new optional `query` request parameter `hash`
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - …3 more
- **2025-08-14** `0e0247c98990`: 1 info
  - endpoint added
- **2025-03-11** `2b736ca1b025`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/alchemillahq/apis/sylve-api/changes/system/file-explorer/download/get.md)

---

[API](https://skmtc.dev/alchemillahq/apis/sylve-api.md) - [All operations](https://skmtc.dev/alchemillahq/apis/sylve-api/llms.txt) - [OpenAPI document](https://skmtc.dev/alchemillahq/apis/sylve-api/revisions/9565cdd0abf5?raw)