Skip to main content
GET
Download or preview a file

Restrictions

Usage

  • Take the full URL from /safari/artifact/sign; authenticate with an app_key of the same member that signed it. An expired or foreign token fails with ResourceNotFound.
  • Files in object storage return 302 to a presigned URL valid for 5 minutes; follow redirects. CSV files in download mode, and files kept on a runner, are streamed directly with 200.
  • download mode of a CSV file prepends a UTF-8 byte order mark (if missing) and sets Content-Type: text/csv; charset=utf-8 so spreadsheet apps open it correctly.
  • A file kept on a runner that is no longer reachable returns 410 with a plain-text message; re-run the task to regenerate the file.
  • Responses carry Cache-Control: private, no-store.

Authorizations

app_key
string
query
required

APP Key created in the Flashduty console under My → APP Key. Send it as the app_key query parameter or in the Fd-App-Key request header. Its effective access is the intersection of the key's permission scope and the creator's current role permissions. Keep it secret.

Query Parameters

t
string
required

Signed token issued by POST /safari/artifact/sign. Bound to the calling account and person; valid for 5 minutes.

mode
enum<string>
default:download

download (default) serves the file as an attachment; preview serves it inline for browser display. Any other value falls back to download.

Available options:
download,
preview

Response

File bytes, returned directly for files kept on a runner and for CSV files in download mode. Content-Disposition is attachment or inline according to mode.

The response is of type file.