Skip to main content
POST
/
api
/
storage
/
buckets
/
{bucketName}
/
objects
/
{objectKey}
/
download-strategy
Get Download Strategy (Direct or Presigned URL)
curl --request POST \
  --url https://api.example.com/api/storage/buckets/{bucketName}/objects/{objectKey}/download-strategy \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "expiresIn": 3600
}
'
{
  "method": "direct",
  "url": "https://s3-bucket.s3.us-east-2.amazonaws.com/app-key/public-assets/logo.png"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
bucketName
string
required
​
objectKey
string
required

Body

application/json
​
expiresIn
integer
default:3600

URL expiration time in seconds (default 3600)

Example:

3600

Response

Download strategy details

​
method
enum<string>
required

Download method:

  • direct: Direct URL access (S3 public buckets or local storage)
  • presigned: Secure URL with signature and expiration (S3 private buckets)
Available options:
presigned,
direct
Example:

"direct"

​
url
string
required

URL to download the file from

Example:

"https://s3-bucket.s3.us-east-2.amazonaws.com/app-key/public-assets/logo.png"

​
expiresAt
string<date-time>

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

Example:

"2025-09-05T01:00:00Z"

​
headers
object

Optional headers to include in the download request