v3

latestOpenAPI 3.0.32026-07-21354289.5 KB

File

downloadS3File

Generate a pre-signed download URL for a file using its S3 reference.

Use this endpoint when you have the S3 bucket and key but not the file entity ID.

post/v1/files:downloadS3

Query parameters

s3_keystring required

The S3 object key, as returned in s3ref.key of the file entity.

Note: object keys store the filename segment percent-encoded. For example, a file named Straße 1.pdf is stored under the key .../Stra%C3%9Fe%201.pdf, and that is the value s3ref.key contains. Pass it exactly as returned by the API and make sure your HTTP client URL-encodes the query parameter value, so a literal % arrives encoded as %25.

s3_bucketstring required

The S3 bucket name

attachmentboolean

Controls the Content-Disposition header. Set to true to trigger browser download dialog, false to display inline.

Response

Pre-signed download URL

download_urlstring uri

Pre-signed S3 URL valid for downloading the file

Example response

{
  "download_url": "https://epilot-prod-user-content.s3.eu-central-1.amazonaws.com/123/temp/4d689aeb-1497-4410-a9fe-b36ca9ac4389/document.pdf?AWSParams=123"
}