Sign in

v1

latestOpenAPI 3.0.32026-07-26172157253.6 KB
Client

Get Download Strategy (Direct or Presigned URL)

Returns download strategy based on storage backend and bucket visibility.

  • S3 with public bucket: Direct URLs (no presigning, better performance)
  • S3 with private bucket: Presigned URLs with expiration
  • Local storage: Always direct endpoints

Expiry (when presigned) is auto-calculated server-side from bucket visibility; no request body is accepted.

Object keys may contain / (pseudo-folders); the path is matched with a wildcard, so callers should NOT percent-encode / inside objectKey.

get/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}

Path parameters

bucketNamestring required
objectKeystring required

Response

Download strategy details

method'presigned' | 'direct' required

Download method:

  • direct: Direct URL access (S3 public buckets or local storage)
  • presigned: Secure URL with signature and expiration (S3 private buckets)
urlstring required

URL to download the file from

expiresAtstring date-time

Expiration time for presigned URLs (only present when method is 'presigned')

headersobject

Optional headers to include in the download request

Example response

{
  "method": "direct",
  "url": "https://s3-bucket.s3.us-east-2.amazonaws.com/app-key/public-assets/logo.png",
  "expiresAt": "2025-09-05T01:00:00Z"
}