Raw Search

Generate a download URL for a raw file

Return a short-lived URL that allows downloading a raw file. Either provide the sha256_original hash directly or specify both container_id and entry_path so the hash can be resolved.

You can pass parameters either as query string or in the JSON body. If both are provided, the JSON body values take precedence.

post/raw/download

Query parameters

sha256_originalstring nullable

SHA-256 of the original file (alternative to container_id + entry_path).

container_idinteger nullable

Container identifier (with entry_path, resolves the file hash).

entry_pathstring nullable

Path of the entry inside the container.

expires_ininteger

Download URL lifetime in seconds (60–3600, default 900).

Request body

object nullable required

Optional JSON body with sha256_original, container_id, entry_path, expires_in. Example: {"sha256_original": "...", "container_id": 123, "entry_path": "path/to/file", "expires_in": 900}

Example request

{
  "container_id": 123,
  "entry_path": "db/users.txt",
  "expires_in": 900
}

Response

Download URL generated successfully.

urlstring required

Temporary URL that can be used to download the file.

expires_ininteger

Number of seconds before the download URL expires.

file_namestring nullable

Suggested file name for the downloaded file.

size_bytesinteger nullable

Size of the file in bytes, when known.

mimestring nullable

MIME type of the file, when available.

already_unlockedboolean

True when the user had an active unlock for the file prior to this request.

downloaded_beforeboolean

Indicates whether the user has successfully downloaded this file in the past.

Changes

No recorded changes to this endpoint across all 1 revision of this API.