Get a file download URL

GET/v1/files/{id}/url

Returns a temporary download URL for the file. Only available for files in COMPLETED status. Works for any retrievable file id, including files uploaded through the app.

Synced email attachments are fetched from the mail provider on first download. If the provider fails, the call returns 502 with code mail_attachment_provider_unavailable. Retry with backoff, and stop after a few attempts: some attachments fail on every request.

Required scope: files:read

Rate limit category: Read

Path ParametersExpand Collapse

id: string

Unique identifier of the file to download.

ReturnsExpand Collapse

FileURLResponse object { expiresAt, url }

expiresAt: string

When the download URL expires.

url: string

Temporary download URL for the file.

Get a file download URL

curl https://api.lightfield.app/v1/files/$ID/url \
    -H 'Lightfield-Version: 2026-03-01' \
    -H "Authorization: Bearer $API_KEY"

{
  "expiresAt": "expiresAt",
  "url": "url"
}

Returns Examples

{
  "expiresAt": "expiresAt",
  "url": "url"
}