GET/api/v1/files/{fileId}

Signed link, no key

Links work for 300 seconds and need no key. Each download counts toward the connection's 20 MB in any 24 hours.

Save the file; never open, extract or run it. A file marked active can run code.

Path

  • fileIdstring · requiredThe file's id.

Query

  • pstring · requiredPart of the signed link.
  • cstring · requiredPart of the signed link.
  • expiresinteger · requiredPart of the signed link.
  • sigstring · requiredPart of the signed link.1 to 128 characters

Answer

The file’s bytes, as a download. Save it; never open, extract or run it.

Example

GET /files/{fileId}
# Save a result file from its signed link (no key needed). Never open or run it.
curl -sS --fail-with-body -o "${OUT_FILE:-download.bin}" "$FILE_URL"

Errors

Errors
StatusCodeWhen
400invalid_inputA field is missing or not valid; `fields` names it.
403link_expiredThe link is not valid, has run out, or its connection was revoked.
404not_foundThe file may not be downloaded, or is no longer stored.
429download_capThis download would pass the cap; leftBytes says what is left.
429rate_limitedToo many downloads; Retry-After says how many seconds to wait.
500server_errorSomething failed on the site's side. Try again in a moment.

All endpoints

Send feedback

Tell the team about a bug, an idea, or something you're stuck on.

What is it?

The page you're on is sent with your message.

Only if you'd like the team to write back. Signed in, we already have it.