Skip to main content

Dependencies

No additional dependencies - uses aiohttp (included). For credential setup, see the OneDrive Setup guide.

Configuration

import os
from mirage import Workspace, MountMode
from mirage.resource.onedrive import OneDriveConfig, OneDriveResource

config = OneDriveConfig(
    access_token=os.environ["ONEDRIVE_ACCESS_TOKEN"],
    drive_id=os.environ.get("ONEDRIVE_DRIVE_ID"),  # omit for delegated /me/drive
)
resource = OneDriveResource(config=config)
ws = Workspace({"/onedrive/": resource}, mode=MountMode.WRITE)

Config Reference

FieldRequiredDescription
access_tokenYesMicrosoft Graph OAuth2 bearer token
drive_idNoTarget a specific drive. Required for app-only tokens (no /me/drive)
site_idNoResolve a SharePoint site’s default drive instead of /me/drive
key_prefixNoMount a sub-folder of the drive as the root
timeoutNoRequest timeout in seconds (default 30)
Drive resolution order: drive_id -> the site_id site’s default drive -> /me/drive.