Skip to main content
POST
Update Bucket Config (Legacy)
Deprecated: This endpoint only supports S3-compatible storage. Use the dedicated endpoints instead:

Overview

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

Header Parameters

string
required
Your API key for authentication

Request

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

Response

string
Success confirmation message

Example

Success Response

Error Responses

Verification Process

When you submit bucket configuration, Tornado:
  1. Creates an S3 client with your credentials
  2. Uploads a small uniquely named credential-probe object, then attempts best-effort deletion
  3. If upload validation succeeds, saves the legacy configuration on the API key document. This does not replace a modern saved storage entry
Allow writes and cleanup deletes for the probe, plus reads for delivery. The upload probe does not verify every permission needed by later operations.

Required IAM Permissions

Supported Providers