SynaDrive Python SDK

Official Python client for the SynaDrive cloud storage API.

Installation

pip install synadrive

For better performance with connection pooling:

pip install synadrive[httpx]

Quick Start

from synadrive import SynaDriveClient

# Initialize client
client = SynaDriveClient(
    api_key="your-api-key",
    base_url="https://drive.synavue.com"
)

# List files
files = client.list_files()

# Upload a file
result = client.upload_file("/path/to/document.pdf", folder_id="folder-id")

# Download a file
client.download_file("file-id", save_path="./downloaded.pdf")

# Create a folder
folder = client.create_folder("My New Folder")

# Share a file
client.share("file-id", email="colleague@company.com", permission="edit")

# Search
results = client.search("quarterly report")

Authentication

The SDK supports two authentication methods:

# 1. Pass token directly
client = SynaDriveClient(api_key="your-token")

# 2. Environment variable
# export SYNADRIVE_API_KEY=your-token
client = SynaDriveClient()

Context Manager

with SynaDriveClient(api_key="your-key") as client:
    files = client.list_files()
    # Connection is automatically closed

Features

• Zero required dependencies — works with Python stdlib (urllib)
• Optional httpx — install synadrive[httpx] for connection pooling & HTTP/2
• Full API coverage — files, folders, sharing, search, trash, versions, sync, AI
• Type hints — full typing support for IDE autocompletion
• Cross-platform — works on macOS, Linux, Windows
• Python 3.8+ — supports all modern Python versions

API Reference

Files

Folders

Sharing

Search

Sync

Trash

AI Features

Error Handling

from synadrive import SynaDriveClient, SynaDriveError, AuthenticationError, NotFoundError

try:
    client.get_file("invalid-id")
except AuthenticationError:
    print("Token expired — re-authenticate")
except NotFoundError:
    print("File not found")
except SynaDriveError as e:
    print(f"API error {e.status_code}: {e}")

License

MIT — © 2026 SynaVue Technologies