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

Documentation Index

Fetch the complete documentation index at: https://docs.insforge.dev/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
bucketName
string
required
Pattern: ^[a-zA-Z0-9_-]+$
​
objectKey
string
required

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