Skip to main content
POST
https://api.tornadoapi.io
/
user
/
bucket
Update Bucket Config
curl --request POST \
  --url https://api.tornadoapi.io/user/bucket \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <x-api-key>' \
  --data '
{
  "endpoint": "<string>",
  "bucket": "<string>",
  "region": "<string>",
  "access_key": "<string>",
  "secret_key": "<string>"
}
'
{
  "message": "Bucket configuration updated successfully"
}

​
Overview

Configure a custom S3-compatible storage bucket for your downloads. Credentials are verified before saving.

​
Header Parameters

​
x-api-key
string
required
Your API key for authentication

​
Request

​
endpoint
string
required
S3 endpoint URL (e.g., https://s3.us-east-1.amazonaws.com)
​
bucket
string
required
Bucket name
​
region
string
required
AWS region (e.g., us-east-1, auto for R2)
​
access_key
string
required
AWS Access Key ID or equivalent
​
secret_key
string
required
AWS Secret Access Key or equivalent

​
Response

​
message
string
Success confirmation message

​
Example

curl -X POST "https://api.tornadoapi.io/user/bucket" \
  -H "x-api-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "endpoint": "https://s3.us-east-1.amazonaws.com",
    "bucket": "my-tornado-downloads",
    "region": "us-east-1",
    "access_key": "AKIAIOSFODNN7EXAMPLE",
    "secret_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY"
  }'

​
Success Response

{
  "message": "Bucket configuration updated successfully"
}

​
Error Responses

{
  "error": "Verification failed: Access Denied"
}

​
Verification Process

When you submit bucket configuration, Tornado:
  1. Creates an S3 client with your credentials
  2. Attempts to list the bucket (verifies read access)
  3. If successful, saves the configuration
Ensure your credentials have both read and write permissions before configuring.

​
Required IAM Permissions

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "s3:PutObject",
        "s3:GetObject",
        "s3:ListBucket"
      ],
      "Resource": [
        "arn:aws:s3:::your-bucket-name",
        "arn:aws:s3:::your-bucket-name/*"
      ]
    }
  ]
}

​
Supported Providers

ProviderEndpoint FormatRegion
AWS S3https://s3.{region}.amazonaws.comYour region
Cloudflare R2https://{account_id}.r2.cloudflarestorage.comauto
OVH Object Storagehttps://s3.{region}.cloud.ovh.netYour region
MinIOYour MinIO URLYour region
DigitalOcean Spaceshttps://{region}.digitaloceanspaces.comYour region
Backblaze B2https://s3.{region}.backblazeb2.comYour region
Wasabihttps://s3.{region}.wasabisys.comYour region