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>'

import requests

url = "https://api.example.com/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.example.com/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "method": "presigned",
  "url": "https://s3-bucket.s3.us-east-2.amazonaws.com/app-key/public-assets/logo.png"
}

Client

Get Download Strategy (Direct or Presigned URL)

Returns the download strategy based on the storage backend, bucket visibility, and the S3_USE_PRESIGNED_URLS configuration.

S3 with S3_USE_PRESIGNED_URLS=true: Returns method: presigned for both public and private buckets. Bucket visibility only affects the URL expiration period.
S3 with S3_USE_PRESIGNED_URLS=false (proxy mode): Returns method: direct using the backend download endpoint.
Local storage: Returns method: direct using the backend download endpoint.

Clients must determine the download flow from the returned method field.

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}

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>'

import requests

url = "https://api.example.com/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}"

headers = {"x-api-key": "<api-key>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.example.com/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.example.com/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.example.com/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.example.com/api/storage/buckets/{bucketName}/download-strategy/objects/{objectKey}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "method": "presigned",
  "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

Pattern: ^[a-zA-Z0-9_-]+$

objectKey

string

required

Response

Download strategy details

method

enum<string>

required

Download method:

direct: Direct backend endpoint for local storage or S3 proxy mode (S3_USE_PRESIGNED_URLS=false)
presigned: Signed download URL returned when S3_USE_PRESIGNED_URLS=true for both public and private S3 buckets. Bucket visibility only affects the URL expiration period.

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

⌘I

Tables

Schedules

Authentication

Records

Storage

Model Gateway

Functions

Realtime

Messaging

Payments

Secrets

Logs

Usage

Metadata

Health

Deployments

Dashboard

Get Download Strategy (Direct or Presigned URL)

Authorizations

Path Parameters

Response