Your files. Your S3 tools.

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

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

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

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

# Direct PutObject test (works with an Upload only key)
$ aws --profile dosya-guide --endpoint-url https://api.dosya.dev/s3 --region us-east-1 s3api put-object \
    --bucket ws_your_workspace_id --key test.txt --body ./test.txt

# Upload an entire folder
$ aws --profile dosya-guide --endpoint-url https://api.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 --profile dosya-guide --endpoint-url https://api.dosya.dev/s3 s3 sync \
    ./backups/ s3://ws_your_workspace_id/backups/

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

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

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

# Copy a file within a workspace
$ aws --profile dosya-guide --endpoint-url https://api.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 --profile dosya-guide --endpoint-url https://api.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 { fromIni } from "@aws-sdk/credential-providers";
import { readFileSync } from "fs";

const client = new S3Client({
    endpoint: "https://api.dosya.dev/s3",
    region: "us-east-1",
    credentials: fromIni({ profile: "dosya-guide" }),
    forcePathStyle: true,
});

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

// Upload a small file (use a multipart uploader for large files)
await client.send(new PutObjectCommand({
    Bucket: "ws_your_workspace_id",
    Key: "Documents/report.pdf",
    Body: readFileSync("./report.pdf"),
}));

# Python with boto3
import boto3
from botocore.config import Config

session = boto3.Session(profile_name="dosya-guide")
client = session.client("s3",
    endpoint_url="https://api.dosya.dev/s3",
    config=Config(s3={"addressing_style": "path"}),
    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",
)