Skip to main content
GET
Get file download URL
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

Get a signed download URL for a file Generates a time-limited signed URL that can be used to download the file directly from cloud storage. URL Expiration:
  • Default: 1 hour
  • Configurable via expirationHours query parameter (1-24 hours)
  • After expiration, request a new URL
Usage Flow:
  1. Call this endpoint with the file ID
  2. Receive a signed download URL
  3. Use the URL to download the file directly (no auth required for the URL itself)
  4. URL expires after the specified time
Authorization:
  • Required role: user or higher

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Path Parameters

id
string<uuid>
required

The UUID of the file to download

Query Parameters

expirationHours
integer
default:1

URL expiration time in hours (1-24, default 1)

Required range: 1 <= x <= 24

Response

Download URL generated successfully

status
enum<string>
Available options:
success
message
string
data
object