OneDrive API integration with managed OAuth via Microsoft Graph. Manage files, folders, and sharing. Use this skill when users want to upload, download, orga...
Real data. Real impact.
Emerging
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
Access the OneDrive API with managed OAuth authentication via Microsoft Graph. Manage files, folders, drives, and sharing with full CRUD operations.
# List files in OneDrive root python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/one-drive/v1.0/me/drive/root/children') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
https://gateway.maton.ai/one-drive/v1.0/{resource}
The gateway proxies requests to
graph.microsoft.comAll requests require the Maton API key in the Authorization header:
Authorization: Bearer $MATON_API_KEY
Environment Variable: Set your API key as
MATON_API_KEYexport MATON_API_KEY="YOUR_API_KEY"
Manage your OneDrive OAuth connections at
https://ctrl.maton.aipython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections?app=one-drive&status=ACTIVE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json data = json.dumps({'app': 'one-drive'}).encode() req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Content-Type', 'application/json') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
Response:
{ "connection": { "connection_id": "3f17fb58-4515-4840-8ef6-2bbf0fa67e2c", "status": "ACTIVE", "creation_time": "2026-02-07T08:23:30.317909Z", "last_updated_time": "2026-02-07T08:24:04.925298Z", "url": "https://connect.maton.ai/?session_token=...", "app": "one-drive", "metadata": {} } }
Open the returned
urlpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections/{connection_id}', method='DELETE') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If you have multiple OneDrive connections, specify which one to use with the
Maton-Connectionpython <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://gateway.maton.ai/one-drive/v1.0/me/drive') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') req.add_header('Maton-Connection', '3f17fb58-4515-4840-8ef6-2bbf0fa67e2c') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
If omitted, the gateway uses the default (oldest) active connection.
GET /one-drive/v1.0/me/drive
Response:
{ "id": "b!F3Y7M0VT80OO9iu_D6Z-LA...", "driveType": "personal", "name": "OneDrive", "owner": { "user": { "displayName": "John Doe", "id": "d4648f06c91d9d3d" } }, "quota": { "total": 5368709120, "used": 1234567, "remaining": 5367474553 } }
GET /one-drive/v1.0/me/drives
GET /one-drive/v1.0/drives/{drive-id}
GET /one-drive/v1.0/me/drive/root
GET /one-drive/v1.0/me/drive/root/children
Response:
{ "value": [ { "id": "F33B7653325337C3!s88...", "name": "Documents", "folder": { "childCount": 5 }, "createdDateTime": "2024-01-15T10:30:00Z", "lastModifiedDateTime": "2024-02-01T14:20:00Z" }, { "id": "F33B7653325337C3!s3f...", "name": "report.pdf", "file": { "mimeType": "application/pdf", "hashes": { "sha1Hash": "cf23df2207d99a74fbe169e3eba035e633b65d94" } }, "size": 35212 } ] }
GET /one-drive/v1.0/me/drive/items/{item-id}
Use colon (
:GET /one-drive/v1.0/me/drive/root:/Documents/report.pdf
GET /one-drive/v1.0/me/drive/root:/Documents:/children
GET /one-drive/v1.0/me/drive/items/{item-id}/children
Access known folders by name:
GET /one-drive/v1.0/me/drive/special/documents GET /one-drive/v1.0/me/drive/special/photos GET /one-drive/v1.0/me/drive/special/music GET /one-drive/v1.0/me/drive/special/approot
GET /one-drive/v1.0/me/drive/recent
GET /one-drive/v1.0/me/drive/sharedWithMe
GET /one-drive/v1.0/me/drive/root/search(q='{query}')
Example:
GET /one-drive/v1.0/me/drive/root/search(q='budget')
POST /one-drive/v1.0/me/drive/root/children Content-Type: application/json{ "name": "New Folder", "folder": {}, "@microsoft.graph.conflictBehavior": "rename" }
Create folder inside another folder:
POST /one-drive/v1.0/me/drive/items/{parent-id}/children Content-Type: application/json{ "name": "Subfolder", "folder": {} }
PUT /one-drive/v1.0/me/drive/items/{parent-id}:/{filename}:/content Content-Type: application/octet-stream{file binary content}
Example - upload to root:
PUT /one-drive/v1.0/me/drive/root:/document.txt:/content Content-Type: text/plainHello, OneDrive!
For files over 4MB, use resumable upload:
Step 1: Create upload session
POST /one-drive/v1.0/me/drive/root:/{filename}:/createUploadSession Content-Type: application/json{ "item": { "@microsoft.graph.conflictBehavior": "rename" } }
Response:
{ "uploadUrl": "https://sn3302.up.1drv.com/up/...", "expirationDateTime": "2024-02-08T10:00:00Z" }
Step 2: Upload bytes to the uploadUrl
Get the file metadata to retrieve the download URL:
GET /one-drive/v1.0/me/drive/items/{item-id}
The response includes
@microsoft.graph.downloadUrl{ "id": "...", "name": "document.pdf", "@microsoft.graph.downloadUrl": "https://public-sn3302.files.1drv.com/..." }
Use this URL directly to download the file content (no auth header needed).
PATCH /one-drive/v1.0/me/drive/items/{item-id} Content-Type: application/json{ "name": "new-name.txt" }
Move to different folder:
PATCH /one-drive/v1.0/me/drive/items/{item-id} Content-Type: application/json{ "parentReference": { "id": "{new-parent-id}" } }
POST /one-drive/v1.0/me/drive/items/{item-id}/copy Content-Type: application/json{ "parentReference": { "id": "{destination-folder-id}" }, "name": "copied-file.txt" }
Returns
202 AcceptedLocationDELETE /one-drive/v1.0/me/drive/items/{item-id}
Returns
204 No ContentPOST /one-drive/v1.0/me/drive/items/{item-id}/createLink Content-Type: application/json{ "type": "view", "scope": "anonymous" }
Link types:
vieweditembedScopes:
anonymousorganizationResponse:
{ "id": "...", "link": { "type": "view", "scope": "anonymous", "webUrl": "https://1drv.ms/b/..." } }
POST /one-drive/v1.0/me/drive/items/{item-id}/invite Content-Type: application/json{ "recipients": [ {"email": "user@example.com"} ], "roles": ["read"], "sendInvitation": true, "message": "Check out this file!" }
Customize responses with OData query parameters:
$select?$select=id,name,size$expand?$expand=children$filter?$filter=file ne null$orderby?$orderby=name$top?$top=10Example:
GET /one-drive/v1.0/me/drive/root/children?$select=id,name,size&$top=20&$orderby=name
Results are paginated. The response includes
@odata.nextLink{ "value": [...], "@odata.nextLink": "https://graph.microsoft.com/v1.0/me/drive/root/children?$skiptoken=..." }
Use the full URL from
@odata.nextLink// List files in root const response = await fetch( 'https://gateway.maton.ai/one-drive/v1.0/me/drive/root/children', { headers: { 'Authorization': `Bearer ${process.env.MATON_API_KEY}` } } ); const data = await response.json();// Upload a file const uploadResponse = await fetch( 'https://gateway.maton.ai/one-drive/v1.0/me/drive/root:/myfile.txt:/content', { method: 'PUT', headers: { 'Authorization':, 'Content-Type': 'text/plain' }, body: 'Hello, OneDrive!' } );Bearer ${process.env.MATON_API_KEY}
import os import requestsList files in root
response = requests.get( 'https://gateway.maton.ai/one-drive/v1.0/me/drive/root/children', headers={'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}'} ) files = response.json()
Upload a file
upload_response = requests.put( 'https://gateway.maton.ai/one-drive/v1.0/me/drive/root:/myfile.txt:/content', headers={ 'Authorization': f'Bearer {os.environ["MATON_API_KEY"]}', 'Content-Type': 'text/plain' }, data='Hello, OneDrive!' )
graph.microsoft.com:/root:/path/to/file@microsoft.graph.downloadUrlfailreplacerenamecurl -gjq$MATON_API_KEY| Status | Meaning |
|---|---|
| 400 | Missing OneDrive connection or invalid request |
| 401 | Invalid or missing Maton API key |
| 403 | Insufficient permissions |
| 404 | Item not found |
| 409 | Conflict (e.g., item already exists) |
| 429 | Rate limited (check |
| 4xx/5xx | Passthrough error from Microsoft Graph API |
{ "error": { "code": "itemNotFound", "message": "The resource could not be found." } }
MATON_API_KEYecho $MATON_API_KEY
python <<'EOF' import urllib.request, os, json req = urllib.request.Request('https://ctrl.maton.ai/connections') req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}') print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2)) EOF
one-drivehttps://gateway.maton.ai/one-drive/v1.0/me/drive/root/childrenhttps://gateway.maton.ai/v1.0/me/drive/root/childrenNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions
1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.