Datasets
Download a file
Downloads a file attached to a record. You don't build this URL: it arrives on the record, as downloadUrl.
GEThttps://api.clickr.cloud/
- No daily limit.
- Each link works for 1 hour.
Request
curl https://api.clickr.cloud/files/eyJhY2NvdW50SWQiOi…const response = await fetch(`https://api.clickr.cloud/files/eyJhY2NvdW50SWQiOi…`, {
headers: {
},
});
const data = await response.json();import os
import requests
response = requests.get(
"https://api.clickr.cloud/files/eyJhY2NvdW50SWQiOi…",
)
data = response.json()Daily logs carry a downloadUrl on each entry in files, and each Documents record carries its own. The link is the credential, so it needs no API key: follow it as it is, from code or an assistant. It works for 1 hour.
An expired link and one that was never valid get the same answer. Read the record again for a fresh link.
Path parameters
tokenstringRequiredThe signed token at the end of a record's downloadUrl.
Response
200, with the file's bytes, its Content-Type and a Content-Disposition naming the file.
Errors
JSON with an error and, on most, a message saying what to change. All errors
| Status | Error | When |
|---|---|---|
| 404 | Not found | The link has expired, was revoked or was never valid, or the file is no longer on the record. |
| 502 | Upstream error | Buildertrend didn't return the file. Try again shortly. |