EPepilot
File

downloadS3File

Changed on

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

Request

  • Base URL
    https://file.sls.epilot.io
  • URL
    https://file.sls.epilot.io/v1/files:downloadS3
  • Auth
    • HTTP bearer
    • or API key in cookie token

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"
}

Changes