Skip to content

Download File

GET
/utilities/downloads/{uuid}
curl --request GET \
--url 'https://sylve.lan:8181/api/utilities/downloads/example?expires=1&sig=example&id=1&node=example'

Download exactly one file using an unexpired node-bound capability URL; no Bearer token is required

uuid
required
string

Download UUID

expires
required
integer

Expiration time in Unix timestamp

sig
required
string

Signature

id
required
integer
>= 1

Download or torrent member ID

node
required
string

Serving cluster node hostname

File content

Media typeapplication/octet-stream
file

Partial file content

Media typeapplication/octet-stream
file

Malformed capability

Media typeapplication/octet-stream
object
data
error
string
message
string
status
string

Invalid, expired, or tampered capability

Media typeapplication/octet-stream
object
data
error
string
message
string
status
string

Capability target or selected node not found

Media typeapplication/octet-stream
object
data
error
string
message
string
status
string

Range Not Satisfiable

Media typeapplication/octet-stream
string

Unexpected signing, database, or filesystem failure

Media typeapplication/octet-stream
object
data
error
string
message
string
status
string

Selected node forwarding failed

Media typeapplication/octet-stream
object
data
error
string
message
string
status
string

Selected node is offline or unavailable

Media typeapplication/octet-stream
object
data
error
string
message
string
status
string