OneDrive

Configuration

OneDrive source connector integrates with the Microsoft Graph API to extract files.

Supports OneDrive personal and business accounts.

It supports various OneDrive scenarios including personal drives, business drives, and app folder access with intelligent fallback handling.

Source Code: View on GitHub

Authentication

This connector uses OAuth 2.0 authentication. You can connect through the Graffo UI or API using the OAuth flow.

Supported authentication methods:

  • OAuth Browser Flow (recommended for UI)

  • OAuth Token (for programmatic access)

  • Auth Provider (enterprise SSO)

Configuration Options

This connector does not have any additional configuration options.

Data Models

The following data models are available for this connector:

OneDriveDriveEntity

Schema for a OneDrive Drive object.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/drive?view=graph-rest-1.0

Field
Type
Description

id

str

Drive ID.

name

str

Drive name or drive type.

drive_type

Optional[str]

Describes the type of drive represented by this resource (e.g., personal, business, documentLibrary).

owner

Optional[Dict[str, Any]]

Information about the user or application that owns this drive.

quota

Optional[Dict[str, Any]]

Information about the drive's storage quota (total, used, remaining, etc.).

web_url_override

Optional[str]

URL to open the drive.

OneDriveDriveItemEntity

Schema for a OneDrive DriveItem object (file or folder).

Inherits from FileEntity to support file processing capabilities.

Reference: https://learn.microsoft.com/en-us/graph/api/resources/driveitem?view=graph-rest-1.0

Field
Type
Description

id

str

Drive item ID.

name

str

Item name.

description

Optional[str]

Description of the item (if available).

etag

Optional[str]

An eTag for the content of the item. Used for change tracking.

ctag

Optional[str]

A cTag for the content of the item. Used for internal sync.

web_url_override

Optional[str]

URL that displays the resource in the browser.

file

Optional[Dict[str, Any]]

File metadata if the item is a file (e.g., mimeType, hashes).

folder

Optional[Dict[str, Any]]

Folder metadata if the item is a folder (e.g., childCount).

parent_reference

Optional[Dict[str, Any]]

Information about the parent of this item, such as driveId or parent folder path.

Last updated