---
title: "Get single-file download URL"
method: GET
path: "/v1/files/{fileId}/download-url"
tags: ["Files"]
---

# Get single-file download URL

`GET /v1/files/{fileId}/download-url`

Generates a signed download URL for one file while preserving legacy direct-vs-nested storage path compatibility.

## Path parameters

- `fileId` string, required

## Query parameters

- `print_job_id` string
- `printer_task_id` string, uuid
- `claim_generation` string, uuid
- `printer_task_access_token` string, uuid

## Response `200`

Signed download URL

- object — Signed download URL
  - `download_url` string, required

## Other responses

- `404` — File not found
- `500` — Internal server error

## Changes

- **2026-08-12** `85dda1277de0` — 4 info
  - added the new optional `query` request parameter `claim_generation`
  - added the new optional `query` request parameter `print_job_id`
  - added the new optional `query` request parameter `printer_task_access_token`
  - added the new optional `query` request parameter `printer_task_id`
- **2026-07-26** `750c8a136307` — 1 info
  - added the non-success response with the status `500`

[Change history](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/changes/v1/files/:fileId/download-url/get.md)

---

[API](https://skmtc.dev/printhiv3d/apis/hive-api-documentation.md) · [All operations](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/llms.txt) · [OpenAPI document](https://skmtc.dev/printhiv3d/apis/hive-api-documentation/revisions/6fc855b04da9?raw)