Use any S3 client.

# List all buckets (workspaces)
$ aws --endpoint-url https://dosya.dev/s3 s3 ls

# List files in a workspace
$ aws --endpoint-url https://dosya.dev/s3 s3 ls s3://ws_your_workspace_id/

# List files in a subfolder
$ aws --endpoint-url https://dosya.dev/s3 s3 ls s3://ws_your_workspace_id/Documents/

# Upload a single file
$ aws --endpoint-url https://dosya.dev/s3 s3 cp \
    ./report.pdf s3://ws_your_workspace_id/Documents/report.pdf

# Upload an entire folder
$ aws --endpoint-url https://dosya.dev/s3 s3 cp \
    ./my-folder/ s3://ws_your_workspace_id/my-folder/ --recursive

# Sync a local directory (upload only new/changed files)
$ aws --endpoint-url https://dosya.dev/s3 s3 sync \
    ./backups/ s3://ws_your_workspace_id/backups/

# Download a single file
$ aws --endpoint-url https://dosya.dev/s3 s3 cp \
    s3://ws_your_workspace_id/Documents/report.pdf ./report.pdf

# Download an entire folder
$ aws --endpoint-url https://dosya.dev/s3 s3 cp \
    s3://ws_your_workspace_id/Documents/ ./docs/ --recursive

# Delete a file
$ aws --endpoint-url https://dosya.dev/s3 s3 rm \
    s3://ws_your_workspace_id/old-file.txt

# Copy a file within a workspace
$ aws --endpoint-url https://dosya.dev/s3 s3 cp \
    s3://ws_your_workspace_id/report.pdf \
    s3://ws_your_workspace_id/Archive/report-backup.pdf

# Move a file (copy + delete)
$ aws --endpoint-url https://dosya.dev/s3 s3 mv \
    s3://ws_your_workspace_id/temp.txt \
    s3://ws_your_workspace_id/Archive/temp.txt

// Node.js / TypeScript with @aws-sdk/client-s3
import { S3Client, ListObjectsV2Command, PutObjectCommand } from "@aws-sdk/client-s3";
import { readFileSync } from "fs";

const client = new S3Client({
    endpoint: "https://dosya.dev/s3",
    region: "us-east-1",
    credentials: {
        accessKeyId: "DOSYA_XXXXXXXXXXXXXXXX",
        secretAccessKey: "your_s3_secret_key",
    },
    forcePathStyle: true,
});

// List files
const list = await client.send(new ListObjectsV2Command({
    Bucket: "ws_your_workspace_id",
    Prefix: "Documents/",
}));

// Upload a file
await client.send(new PutObjectCommand({
    Bucket: "ws_your_workspace_id",
    Key: "Documents/report.pdf",
    Body: readFileSync("./report.pdf"),
}));

# Python with boto3
import boto3

client = boto3.client("s3",
    endpoint_url="https://dosya.dev/s3",
    aws_access_key_id="DOSYA_XXXXXXXXXXXXXXXX",
    aws_secret_access_key="your_s3_secret_key",
    region_name="us-east-1",
)

# List files
response = client.list_objects_v2(
    Bucket="ws_your_workspace_id",
    Prefix="Documents/",
)

# Upload a file
client.upload_file(
    "./report.pdf",
    "ws_your_workspace_id",
    "Documents/report.pdf",
)