Files

Download a file

Changed on

Get a presigned URL to download the content of a file by its unique identifier.

The response includes a short-lived URL that can be used to download the file directly from cloud storage without additional authentication. The URL is valid for 1 hour; call this endpoint again to mint a fresh URL when needed.

Download availability is based on upload completion and redaction/obfuscation readiness. It is separate from processing status: a file can still report pending or failed from the Get file by id endpoint while the original bytes are available for download.

Images: for privacy, once an uploaded image has been re-encoded to strip embedded metadata (EXIF, XMP, GPS location, camera details) and bake in orientation, this endpoint serves that sanitized derivative instead of the original uploaded bytes. A newly uploaded image downloads as the original (still subject to the readiness rules above) until the sanitized derivative is ready, typically seconds; images in formats that cannot be sanitized (e.g. SVG, HEIC, AVIF) continue to download as the original.

Required scope: file:read

get/v1/files/{file_id}/download

Request

  • Base URL
    https://dovetail.com/api
  • URL
    https://dovetail.com/api/v1/files/{file_id}/download
  • Auth
    HTTP bearer

Path parameters

file_idstring required

Unique identifier of the file.

Response

200

Changes

    • breaking

      added subschema #1 subschema #2 to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from object to no type for status

    • breaking

      removed the required property // from the response with the status

    • breaking

      removed the required property // from the response with the status

    • warning

      removed the optional property // from the response with the status