Onedrive Api

OneDrive API is a Microsoft Graph sub-surface — the same auth (Entra ID / Azure AD) and SDK that provides Outlook, Calendar, and Teams access also covers OneDrive. For agents: upload generated reports to OneDrive, download files for processing, create sharing links for temporary access, and search across a user's drive. Service Principal (application permissions) enables server-side access without user interaction. OneDrive for Business drives integrate tightly with SharePoint document libraries. Large file uploads use resumable upload sessions. Confidence is docs-derived.

Microsoft Graph API at graph.microsoft.com/v1.0/users/{userId}/drive. GET /drive/root/children lists root files/folders. GET /drive/root:/{path}:/children lists folder contents. POST /drive/root:/{path}:/content uploads small file (<4MB, body = file bytes). POST /drive/root:/{path}:/ + createUploadSession creates resumable session for large files (>4MB). GET /drive/items/{itemId} retrieves item metadata. PATCH /drive/items/{itemId} renames/moves item. DELETE /drive/items/{itemId} moves to recycle bin. POST /drive/items/{itemId}/createLink creates sharing link ({type: "view"|"edit", scope: "organization"|"anonymous"}). GET /drive/root/search(q='{query}') searches drive. DriveItem: represents both files and folders.

OAuth2: Application permissions for server-side access — Files.ReadWrite.All scope (allows all users' drives). Service Principal: POST /oauth2/v2.0/token ({client_credentials grant}) → Bearer token. Delegated permissions: Files.ReadWrite for user-specific access (requires user consent). HTTPS enforced. Tenant admin consent: required for Files.ReadWrite.All application permission. Large file upload: session URL returned from createUploadSession — PUT file chunks sequentially. Signing: no webhook signing for OneDrive change notifications — use X-Hub-Signature header (HMAC-SHA256) for delta notifications.

Standard HTTP status codes with JSON error bodies ({error: {code, message}}). 404 for missing item path. 409 for name conflict on upload. Large upload session: expires after 1 day — complete upload within expiry. Session chunk size: must be multiple of 320KB (327,680 bytes). Rate limiting: 10,000 req/10min per app across tenant. Sharing links: scope "anonymous" requires tenant to allow external sharing. Quota: OneDrive storage quota applies per user. Microsoft Graph uptime at admin.microsoft.com/servicestatus. Delta queries: GET /drive/root/delta for incremental change tracking — efficient for sync scenarios.

learn.microsoft.com/onedrive/developer covers OneDrive API reference, large file upload guide, sharing documentation, and delta query guide. Getting started: Azure free account, register app in Entra ID, grant Files.ReadWrite.All permission, get access token — first file upload in under 15 minutes. microsoft-graph-sdk: pip install msgraph-sdk. Community via Microsoft Q&A and Stack Overflow (microsoft-graph, onedrive tags). Documentation is part of the broader Microsoft Graph documentation — comprehensive but requires navigating the Microsoft 365 developer ecosystem.