PApai-os
Downloads Management

Retrieve all downloads

Changed on

Retrieve the information of all downloads.

get/downloads

Request

  • Base URL
    /api/v1 (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    HTTP bearer

Query parameters

sortstring
Example:["title","ASC"]

Specifies the sorting order and field (e.g., ["title", "ASC"]).

rangestring
Example:[0, 24]

Specifies the range of results to return (e.g., [0, 24]).

filterstring
Example:{"title":"bar"}

JSON string specifying the filter conditions (e.g., {"title":"bar"}).

Response

OK

idstring uuid required
source_urlstring uri required
file_namestring

A filename that is valid on macOS, Windows, and Linux

target_directorystring

A uri-style relative path that is valid on macOS, Windows, and Linux

file_hashstring

The hash type and hash of the file separated by colon

file_sizeinteger

Bytes

downloadedinteger

Bytes

progressnumber nullable
status'downloading' | 'paused' | 'processing' | 'completed' | 'verified' | 'failed'
start_timenumber nullable
transfer_ratenumber nullable

Example response

[
  {
    "id": "7bea4732-214f-40e7-9161-4e7241a2b97e",
    "source_url": "https://localhost:8080/v1/api",
    "file_name": "Mistral-7B-Instruct-v0.3-Q8_0.gguf",
    "target_directory": "folder/subfolder/file.txt",
    "file_hash": "sha256:404857e776114baada71a08ebd3bba79d721ec7fca99705e7e7b892ae8bc583f",
    "file_size": 7702565088,
    "downloaded": 7702565088,
    "progress": 10.05,
    "status": "downloading",
    "start_time": 1717398019.4677122,
    "transfer_rate": 49028995.95526451
  }
]

Changes