Skip to main content
POST
/
api
/
storage
/
buckets
/
{bucketName}
/
upload-strategy
{
  "method": "presigned",
  "uploadUrl": "https://s3-bucket.amazonaws.com/",
  "fields": {
    "bucket": "my-s3-bucket",
    "key": "app-key/avatars/profile-photo-1234567890-abc123.jpg",
    "X-Amz-Algorithm": "AWS4-HMAC-SHA256",
    "X-Amz-Credential": "AKIA.../20250905/us-east-2/s3/aws4_request",
    "X-Amz-Date": "20250905T000000Z",
    "Policy": "eyJ...",
    "X-Amz-Signature": "abc123..."
  },
  "key": "profile-photo-1234567890-abc123.jpg",
  "confirmRequired": true,
  "confirmUrl": "/api/storage/buckets/avatars/objects/profile-photo-1234567890-abc123.jpg/confirm-upload",
  "expiresAt": "2025-09-05T01:00:00Z"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
bucketName
string
required

Body

application/json
​
filename
string
required
Example:
​
contentType
string
Example:
​
size
integer
Example:

Response

​
method
enum<string>
required
Available options:
presigned,
direct
Example:
​
uploadUrl
string
required
Example:
​
key
string
required
Example:
​
confirmRequired
boolean
required
Example:
​
fields
object
Example:
​
confirmUrl
string
Example:
​
expiresAt
string<date-time>
Example: