OneDrive

one_drive

OneDrive is Microsoft’s cloud storage solution enabling users to store, sync, and share files across devices, offering offline access, real-time collaboration, and enterprise-grade security

File Management & Storage Web del proveedor

Acciones

Triggers

Autenticación

—

OAuth gestionado

Sí

Información técnica: el detalle de parámetros, schemas y triggers de esta página está pensado para equipos de integración. Si solo necesitas saber si tu herramienta favorita está disponible, basta con ver la lista de acciones.

Acciones disponibles (35)

Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.

Copy ItemONE_DRIVE_COPY_ITEMAcción

Tool to copy a driveitem (file or folder) to a new location asynchronously. use when you need to duplicate an item, optionally renaming it or specifying a different parent folder. the operation is asynchronous; the response provides a url to monitor the copy progress.

Parámetros de entrada

namestring
The new name for the copied item. If not provided, the original name is used.
item_idstringObligatorio
The ID of the DriveItem to be copied.
site_idstring
The ID of the site if the item is in a SharePoint site.
user_idstring
The ID of the user if accessing another user's drive.
drive_idstring
The ID of the drive where the item is located. If not provided, 'me' (user's default drive) is assumed.
group_idstring
The ID of the group if the item is in a group drive.
children_onlyboolean
If set to true, only the children of the source driveItem (if it's a folder) are copied, not the driveItem itself. Defaults to false.
parent_referenceobject
Reference to the parent item (folder) where the copy will be created. If not provided, the item is copied to the same folder as the original.
include_all_version_historyboolean
If set to true, the version history of the source file is copied to the destination. Defaults to false.
@microsoft.graph.conflictBehaviorstringenum
Specifies how to handle a naming conflict if an item with the same name already exists in the destination. 'fail' (default), 'replace', or 'rename'.
failreplacerename

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create Sharing LinkONE_DRIVE_CREATE_LINKAcción

Tool to create a sharing link for a driveitem (file or folder) by its unique id. use when you need to generate a shareable link for an item in onedrive or sharepoint.

Parámetros de entrada

typestringObligatorioenum
The type of sharing link to create.
vieweditembed
scopestringenum
The scope of the link to create. If not specified, the default link type for the organization is created.
anonymousorganizationusers
item_idstringObligatorio
The unique identifier of the drive item (file or folder) for which to create the link.
site_idstring
The unique identifier of the site. Use this if the item is in a SharePoint site's drive.
user_idstring
The unique identifier of the user. Use this if the item is in another user's drive.
drive_idstring
The unique identifier of the drive. If not provided, the link will be created in the current user's drive (me/drive).
group_idstring
The unique identifier of the group. Use this if the item is in a group's drive.
passwordstring
The password for the sharing link. Optional and OneDrive Personal only.
expiration_date_timestring
The expiration date and time for the permission, in yyyy-MM-ddTHH:mm:ssZ format. Example: 2023-12-31T23:59:59Z
retain_inherited_permissionsboolean
If true (default), existing inherited permissions are retained. If false, all existing permissions are removed when sharing for the first time.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Delete ItemONE_DRIVE_DELETE_ITEMAcción

Tool to delete a driveitem (file or folder) by its unique id from the authenticated user's onedrive. use when you need to remove an item from onedrive. this action moves the item to the recycle bin, not permanently deleting it.

Parámetros de entrada

item_idstringObligatorio
The unique identifier of the DriveItem (file or folder) to be deleted.
if_matchstring
(Optional) If this request header is included and the eTag (or cTag) provided doesn't match the current tag on the item, a `412 Precondition Failed` response is returned, and the item won't be deleted.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Download a fileONE_DRIVE_DOWNLOAD_FILEAcción

Downloads a file from a user's onedrive using its item id, which must refer to a file and not a folder.

Parámetros de entrada

item_idstringObligatorio
Unique ID of the file to download; must be a file, not a folder.
user_idstring
User's ID or User Principal Name (UPN), or 'me' for the authenticated user's OneDrive.
file_namestringObligatorio
Desired filename (including extension) for the downloaded content.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get DriveONE_DRIVE_GET_DRIVEAcción

Retrieves the properties and relationships of a drive resource by its unique id. use this action when you need to get details about a specific onedrive, user's onedrive, group's document library, or a site's document library.

Parámetros de entrada

drive_idstringObligatorio
The unique identifier of the drive. This can be the ID of the user's personal OneDrive, a group's document library, or a specific drive ID.
select_fieldsstring[]
A comma-separated list of properties to include in the response. Use this to retrieve specific fields and reduce the response size. For example, "id,name,driveType". If not provided, all default properties are returned.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Item MetadataONE_DRIVE_GET_ITEMAcción

Retrieves the metadata of a driveitem by its unique id. use this tool to get information about a specific file or folder in onedrive when you have its id. if a `drive id` is not provided, it defaults to the user's main drive.

Parámetros de entrada

item_idstringObligatorio
The unique identifier of the DriveItem (file or folder).
drive_idstring
The unique identifier of the Drive where the item is located. If not provided, the action will target the user's personal OneDrive (me/drive).
select_fieldsstring[]
A list of DriveItem properties to return. If not specified, a default set of properties is returned. Refer to the DriveItem resource documentation for available fields.
expand_relationsstring[]
A list of relationships to expand in the response, such as 'children'.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Item PermissionsONE_DRIVE_GET_ITEM_PERMISSIONSAcción

Retrieves the permissions of a driveitem by its unique id or path within a specific drive. use when you need to check who has access to a file or folder and what level of access they have.

Parámetros de entrada

selectstring
A comma-separated list of properties to include in the response. For example, 'id,roles,link'.
item_idstringObligatorio
The unique identifier of the drive item.
site_idstring
The unique identifier of a SharePoint site. Use this if the item is in a SharePoint site's drive.
user_idstring
The unique identifier of a user. Use this if the item is in a specific user's drive (other than 'me').
drive_idstring
The unique identifier of the drive. Required if not using other identifiers like group_id, site_id, or user_id in the path.
group_idstring
The unique identifier of a group. Use this if the item is in a group's drive.
item_pathstring
The path to the item relative to the drive's root. Use this if item_id is not known. Must start with ':/' and end with ':/'. Example: ':/FolderA/FileB.txt:/'. Only applicable when accessing items in the current user's drive (me/drive/root).

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Item ThumbnailsONE_DRIVE_GET_ITEM_THUMBNAILSAcción

Tool to retrieve the thumbnails associated with a driveitem. use when you need to display visual previews of files.

Parámetros de entrada

selectstring
A comma-separated list of thumbnail sizes to retrieve (e.g., "small,medium,large", or "c300x400_crop"). If not specified, all available thumbnails for the first thumbnailSet (id: "0") are returned.
item_idstringObligatorio
The unique identifier of the DriveItem.
site_idstring
The unique identifier of a Site. Provide either drive_id, group_id, site_id, or user_id.
user_idstring
The unique identifier of a User. Provide either drive_id, group_id, site_id, or user_id.
drive_idstring
The unique identifier of the Drive. If not provided, 'me' will be used for the current user's drive.
group_idstring
The unique identifier of a Group. Provide either drive_id, group_id, site_id, or user_id.
original_orientationboolean
If true, retrieves the thumbnail with its original EXIF orientation. This is only supported on OneDrive Personal. Defaults to false.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Item VersionsONE_DRIVE_GET_ITEM_VERSIONSAcción

Tool to retrieve the version history of a driveitem by its unique id. use when you need to access or list previous versions of a file.

Parámetros de entrada

item_idstringObligatorio
The unique identifier of the item (file or folder).
site_idstring
The unique identifier of the site. Mutually exclusive with drive_id, group_id, and user_id.
user_idstring
The unique identifier of the user. Mutually exclusive with drive_id, group_id, and site_id.
drive_idstring
The unique identifier of the drive. Mutually exclusive with group_id, site_id, and user_id. One of these must be provided if not using the /me path.
group_idstring
The unique identifier of the group. Mutually exclusive with drive_id, site_id, and user_id.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Drive QuotaONE_DRIVE_GET_QUOTAAcción

Tool to retrieve the quota information for the authenticated user's onedrive. use this action to check the storage space details like total, used, and remaining space on the user's onedrive.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Recent ItemsONE_DRIVE_GET_RECENT_ITEMSAcción

Retrieves a list of items that have been recently used by the authenticated user. this tool is useful when you need to access or display files and folders that the user has interacted with recently across their onedrive and accessible shared drives.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Shared ItemsONE_DRIVE_GET_SHARED_ITEMSAcción

Tool to retrieve a list of items that have been shared with the authenticated user. use this action to get details of files and folders shared with the current user.

Parámetros de entrada

allow_externalboolean
Set to true to include items shared from external tenants. Defaults to false, which only returns items shared within the user's own tenant.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get SharePoint List ItemsONE_DRIVE_GET_SHAREPOINT_LIST_ITEMSAcción

Tool to get the items (list items) within a specific sharepoint list on a site. use when you need to retrieve data from a sharepoint list.

Parámetros de entrada

expandstring
A comma-separated list of relationships to expand, or 'fields(select=columnName1,columnName2)' to retrieve specific fields. For example, to get specific columns 'Name' and 'Color', use 'fields(select=Name,Color)'.
filterstring
An OData filter query to restrict the results. For example, to filter items where 'Quantity' is less than 600, use 'fields/Quantity lt 600'.
selectstring
A comma-separated list of properties to include in the response. Often used in conjunction with '$expand=fields(select=...)'. For example, 'id,name,fields'.
list_idstringObligatorio
The unique identifier of the list within the SharePoint site.
site_idstringObligatorio
The unique identifier of the SharePoint site.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get Site DetailsONE_DRIVE_GET_SITE_DETAILSAcción

Retrieves metadata for a specific sharepoint site by its id. use this action when you need to get details like display name, web url, and creation/modification dates for a known sharepoint site.

Parámetros de entrada

site_idstringObligatorio
The unique identifier of the SharePoint site. This is the id property of the site resource.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Get SharePoint Site Page ContentONE_DRIVE_GET_SITE_PAGE_CONTENTAcción

Gets the content of a modern sharepoint site page. use when you need to retrieve the details and content of a specific page within a sharepoint site.

Parámetros de entrada

expandstring
Expands related entities. For example, use 'canvasLayout' to include the page's layout and web part content.
page_idstringObligatorio
The unique identifier of the site page.
site_idstringObligatorio
The unique identifier of the SharePoint site.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Invite User to Drive ItemONE_DRIVE_INVITE_USER_TO_DRIVE_ITEMAcción

Tool to invite users or grant permissions to a specific item in a onedrive drive. use when you need to share a file or folder with other users and define their access level (e.g., read or write).

Parámetros de entrada

rolesstring[]Obligatorio
Specifies the roles to be granted to the recipients.
item_idstringObligatorio
The unique identifier of the drive item (file or folder).
messagestring
A plain text formatted message that is included in the sharing invitation. Maximum length 2000 characters.
site_idstring
The unique identifier of a SharePoint site. Use this if the item is in a SharePoint site's drive.
user_idstring
The unique identifier of a user. Use this if the item is in another user's drive that you have access to.
drive_idstring
The unique identifier of the drive. If not provided, the authenticated user's personal drive (me/drive) will be used.
group_idstring
The unique identifier of a Microsoft 365 group. Use this if the item is in a group's drive.
passwordstring
The password set on the invite by the creator. Optional and OneDrive Personal only.
recipientsobject[]Obligatorio
A collection of recipients who will receive access and the sharing invitation.
require_sign_inboolean
Specifies whether the recipient of the invitation is required to sign-in to view the shared item.
send_invitationboolean
If true, a sharing link is sent to the recipient. Otherwise, a permission is granted directly without sending a notification.
expiration_date_timestring
Specifies the dateTime after which the permission expires. ISO 8601 format. Example: "2023-12-31T23:59:59.000Z"
retain_inherited_permissionsboolean
Optional. If true (default), any existing inherited permissions are retained on the shared item when sharing this item for the first time. If false, all existing permissions are removed when sharing for the first time.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Drive Item ActivitiesONE_DRIVE_LIST_DRIVE_ITEM_ACTIVITIESAcción

Tool to list recent activities for a specific item in a onedrive drive. use when you need to track changes or actions performed on a file or folder.

Parámetros de entrada

$topinteger
Show only the first n items.
$skipinteger
Skip the first n items.
$filterstring
Filter items by property values.
item_idstringObligatorio
The unique identifier of the driveItem.
$orderbystring
Order items by property values.
drive_idstringObligatorio
The unique identifier of the drive.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List DrivesONE_DRIVE_LIST_DRIVESAcción

Tool to retrieve a list of drive resources available to the authenticated user, or for a specific user, group, or site. use when you need to find out what drives are accessible.

Parámetros de entrada

topinteger
The maximum number of items to return in a single page. Must be between 1 and 999.
expandstring
Comma-separated list of relationships to expand (e.g., "root,list").
selectstring
Comma-separated list of properties to include in the response (e.g., "id,name,driveType").
orderbystring
A comma-separated list of properties to order the results by, optionally followed by "asc" or "desc" (e.g., "name desc").
site_idstring
The ID of the site to list drives for. If provided, group_id and user_id should not be used.
user_idstring
The ID of the user to list drives for. If provided, group_id and site_id should not be used. If none of group_id, site_id, or user_id are provided, the drives for the current authenticated user (/me/drives) will be listed.
group_idstring
The ID of the group to list drives for. If provided, site_id and user_id should not be used.
skip_tokenstring
A token used to retrieve the next page of results.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Root Drive ChangesONE_DRIVE_LIST_ROOT_DRIVE_CHANGESAcción

Tool to list changes in the root of the user's primary drive using a delta token. use when you need to track file and folder modifications, additions, or deletions in the main onedrive directory.

Parámetros de entrada

tokenstring
A string token that represents the state of the drive from a previous call. It can be a deltaLink from a previous response, the literal string 'latest' to get a token for future calls without enumerating current items, or omitted to get all current items and a nextLink or deltaLink.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List SharePoint List Items DeltaONE_DRIVE_LIST_SHAREPOINT_LIST_ITEMS_DELTAAcción

Tool to track changes to items in a sharepoint list using a delta query. use when you need to get newly created, updated, or deleted list items without performing a full read of the entire item collection.

Parámetros de entrada

topinteger
Maximum number of items to return in a single response.
tokenstring
If unspecified or empty, enumerates the current state. If 'latest', returns an empty response with the latest delta token. If a previous delta token, returns changes since that token.
expandstring
Comma-separated list of relationships to expand.
selectstring
Comma-separated list of listItem properties to return.
list_idstringObligatorio
The unique identifier of the list within the site.
site_idstringObligatorio
The unique identifier of the SharePoint site.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Site ColumnsONE_DRIVE_LIST_SITE_COLUMNSAcción

Tool to list all column definitions for a sharepoint site. use this when you need to retrieve the schema or structure of columns within a specific sharepoint site.

Parámetros de entrada

topinteger
The maximum number of items to return.
skipinteger
The number of items to skip before starting to collect the result set.
expandstring
Comma-separated list of related resources to expand in the response.
filterstring
OData filter expression to apply to the results.
selectstring
Comma-separated list of properties to include in the response.
orderbystring
Comma-separated list of properties used to sort the results.
site_idstringObligatorio
The unique identifier of the SharePoint site. Example: `contoso.sharepoint.com,2C712604-133D-4A7C-9194-F53CE4C952A2,A704AEF5-C2C0-43C3-A3D8-9F55A73A02E2`

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Site Drive Items DeltaONE_DRIVE_LIST_SITE_DRIVE_ITEMS_DELTAAcción

Tool to track changes to driveitems in the default document library of a sharepoint site. use when you need to get a list of items that have been added, modified, or deleted since a previous state or to get an initial enumeration of all items.

Parámetros de entrada

tokenstring
A token used to retrieve a specific page of results or to get changes since a previous state. Can be 'latest' to get the most recent delta token without items, a deltaLink URL, or a timestamp (YYYY-MM-DDTHH:MM:SSZ).
site_idstringObligatorio
The unique identifier of the SharePoint site.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Site ListsONE_DRIVE_LIST_SITE_LISTSAcción

Tool to list all lists under a specific sharepoint site. use when you need to enumerate lists within a known site.

Parámetros de entrada

topinteger
The maximum number of items to return.
skipinteger
The number of items to skip before starting to collect the result set.
expandstring
Comma-separated list of relationships to expand in the response. Example: columns,items
filterstring
OData filter expression. Example: startswith(name,'Doc')
selectstring
Comma-separated list of properties to include in the response. Example: id,name,list
orderbystring
OData order by expression. Example: name asc
site_idstringObligatorio
The unique identifier of the SharePoint site.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List Site SubsitesONE_DRIVE_LIST_SITE_SUBSITESAcción

Tool to list all subsites of a sharepoint site. use when you need to retrieve a collection of subsites for a given parent site.

Parámetros de entrada

site_idstringObligatorio
The unique identifier of the SharePoint site for which to list subsites.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List SubscriptionsONE_DRIVE_LIST_SUBSCRIPTIONSAcción

Tool to list the current subscriptions for the authenticated user or app. use this to retrieve details of existing webhook subscriptions.

Parámetros de entrada

Sin parámetros.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Move ItemONE_DRIVE_MOVE_ITEMAcción

Tool to move a file or folder to a new parent folder in onedrive. use when you need to reorganize your files or folders by changing their location. you can optionally rename the item during the move.

Parámetros de entrada

namestring
The new name for the DriveItem. If not provided, the item retains its original name.
itemIdstringObligatorio
The unique identifier of the file or folder (DriveItem) to be moved.
driveIdstring
The unique identifier of the Drive that contains the item. If not specified, it defaults to the user's personal drive (`/me/drive`).
parentReferenceobjectObligatorio
The new parent folder reference.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create folderONE_DRIVE_ONEDRIVE_CREATE_FOLDERAcción

Creates a new folder in the user's onedrive, automatically renaming on conflict, optionally within a specified parent folder (by id or full path from root) which, if not the root, must exist and be accessible.

Parámetros de entrada

namestringObligatorio
The desired name for the new folder. If a folder with this name already exists in the specified parent_folder, the new folder will be automatically renamed (e.g., 'New Folder' might become 'New Folder 1'). Examples: ['Annual Reports', 'Client Meeting Notes']
user_idstring
Identifier for the user. This action operates on the currently authenticated user's OneDrive. Examples: ['me']
parent_folderstring
ID or full path of the parent folder for the new folder. Paths must start from the root (e.g., '/Documents/Reports'). If an ID is provided, it refers to an existing folder's unique ID. Examples: ['/Projects/Alpha', 'folder_id_12345ABC', '/']

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Create a new text fileONE_DRIVE_ONEDRIVE_CREATE_TEXT_FILEAcción

Creates a new text file with specified content in a onedrive folder, using either the folder's unique id or its absolute path (paths are automatically resolved to ids); note that onedrive may rename or create a new version if the filename already exists.

Parámetros de entrada

namestringObligatorio
The desired name for the new text file, including its extension (e.g., 'report.txt', 'notes.log').
folderstring
The unique identifier (ID) or an absolute path of the OneDrive folder where the new text file will be created.
contentstringObligatorio
The plain text content to be written into the new file.
user_idstring
The user's ID or the literal 'me' to represent the currently authenticated user.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Find ItemONE_DRIVE_ONEDRIVE_FIND_FILEAcción

Non-recursively finds an item (file or folder) in a specified onedrive folder; if `folder` is provided as a path, it must actually exist.

Parámetros de entrada

namestringObligatorio
The exact name of the file or folder to find within the specified `folder`.
folderstring
The unique identifier (ID) or absolute path of the OneDrive folder for the search. For the root folder, use '/'. Paths must start with '/'.
user_idstring
The unique identifier of the user (e.g., a GUID) or the alias 'me' to represent the currently authenticated user. This determines whose OneDrive will be accessed.
include_metadataboolean
If set to true, the response will include the complete metadata for each found item. If false (default), only essential properties like id, name, and webUrl are returned.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Find FolderONE_DRIVE_ONEDRIVE_FIND_FOLDERAcción

Finds folders by name within an accessible parent folder in onedrive, or lists all its direct child folders if no name is specified.

Parámetros de entrada

namestring
Exact name of the folder to find. If omitted, all direct child folders of the parent `folder` are returned.
folderstring
Path (e.g., '/My Files/Work', '/' for root) or unique ID of the parent folder where child folders are searched.
user_idstring
User's unique identifier (e.g., email, UPN) or 'me' for the authenticated user, specifying the OneDrive account.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

List OneDrive itemsONE_DRIVE_ONEDRIVE_LIST_ITEMSAcción

Retrieves all files and folders as `driveitem` resources from the root of a specified user's onedrive, automatically handling pagination.

Parámetros de entrada

topinteger
Maximum items per API request, setting the batch size; the action automatically handles pagination to fetch all items. The Microsoft Graph API may limit this (e.g., to 999).
selectstring[]
Specifies `driveItem` properties to return. If omitted or empty, default properties are returned. Refer to Microsoft Graph API documentation for a complete list of `driveItem` properties.
user_idstring
User's unique identifier (e.g., 'user@example.com', object ID) or 'me' for the authenticated user's OneDrive.

Parámetros de salida

dataobjectObligatorio
Dictionary with a 'value' key holding a list of all `driveItem` objects (files/folders) from the root of the user's OneDrive, including selected or default properties.
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Upload fileONE_DRIVE_ONEDRIVE_UPLOAD_FILEAcción

Uploads a file to a specified onedrive folder, automatically renaming on conflict and supporting large files via chunking.

Parámetros de entrada

fileobjectObligatorio
The file to be uploaded, including its name and access to its binary content.
folderstring
Destination folder path from root (e.g., '/Documents/Reports') or a unique folder ID.
user_idstring
User ID (e.g., user_principal_name, unique GUID) or 'me' for the authenticated user, determining the target OneDrive.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Preview Drive ItemONE_DRIVE_PREVIEW_DRIVE_ITEMAcción

Generates or retrieves a short-lived embeddable url for a preview of a specific item. use when you need to display a temporary preview of a file.

Parámetros de entrada

pagestring
Optional. Page number of document to start at, if applicable. Specified as string for future use cases around file types such as ZIP.
zoomnumber
Optional. Zoom level to start at, if applicable.
item_idstringObligatorio
The unique identifier of the DriveItem.
site_idstring
The unique identifier of the Site. Provide if the item is in a SharePoint site.
user_idstring
The unique identifier of the User. Provide if the item is in another user's drive.
drive_idstring
The unique identifier of the Drive. If not provided, the request will be made to the current user's drive.
group_idstring
The unique identifier of the Group. Provide if the item is in a group drive.
share_idstring
The unique identifier of the shared item. Provide if the item is accessed via a share link.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Search ItemsONE_DRIVE_SEARCH_ITEMSAcción

Searches for driveitems in onedrive that match the specified query. use this to find files or folders based on keywords.

Parámetros de entrada

qstringObligatorio
The query text used to search for items. Values may be matched across several fields including filename, metadata, and file content.
topinteger
The maximum number of items to return in a single page. Default is 200.
selectstring
Comma-separated list of properties to include in the response.
orderbystring
A comma-separated list of properties used to sort the order of the items in the response. Use 'asc' or 'desc' for ascending or descending order, e.g., 'name asc'.
drive_idstring
The ID of the drive to search within. If not provided, the user's personal drive (me/drive) will be searched. Can also be a group ID, site ID, or user ID.
skip_tokenstring
A token to retrieve the next page of results, obtained from the @odata.nextLink in a previous response.
search_scopestringenum
Specifies the scope of the search. 'root' searches within a specific folder hierarchy (default if drive_id is specified for a drive item, or /me/drive/root). 'drive' broadens the search to include items shared with the current user (used with /me/drive/search).
driveroot

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Update Drive Item MetadataONE_DRIVE_UPDATE_DRIVE_ITEM_METADATAAcción

Tool to update the metadata of a specific item (file or folder) in onedrive. use this to rename items, change descriptions, or move items to a new parent folder.

Parámetros de entrada

namestring
The new name for the drive item.
item_idstringObligatorio
The unique identifier of the drive item (file or folder) to update.
site_idstring
The unique identifier of the site. Used when updating an item within a site's drive.
user_idstring
The unique identifier of the user. Used when updating an item within a specific user's drive.
drive_idstring
The unique identifier of the drive. Required if not using other specific paths like /me, /groups/{group-id}, /sites/{site-id}, or /users/{user-id}.
group_idstring
The unique identifier of the group. Used when updating an item within a group's drive.
descriptionstring
The new description for the drive item.
parent_reference_idstring
The ID of the new parent item. Use this to move the item. The driveId of the parentReference can also be specified if moving between drives.
additional_propertiesobject
Allows passing any other updatable DriveItem properties not explicitly defined in the model.
parent_reference_drive_idstring
The drive ID of the new parent item, if moving to a different drive.

Parámetros de salida

dataobjectObligatorio
Data from the action execution
errorstring
Error if any occurred during the execution of the action
successfulbooleanObligatorio
Whether or not the action execution was successful or not

Triggers (9)

Los triggers son eventos externos que pueden iniciar un flujo en tus agentes (ej: nuevo email, mensaje recibido, registro creado).

OnedrivebasetriggerONE_DRIVE_BASE_TRIGGERTrigger

Base trigger for OneDrive changes using Gmail-style state management. Subclasses override `filter_changes(...)` to extract only the relevant items.

Configuración

drive_pathstring
The path in OneDrive to monitor for changes. Default is root.
include_deletedboolean
Whether to include deleted items in the changes
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

event_typestringObligatorio
Type of change event (created, modified, deleted)
itemobjectObligatorio
The OneDrive item that changed

OneDrive File Created TriggerONE_DRIVE_FILE_CREATED_TRIGGERTrigger

Triggers when a new file is created in OneDrive. Uses Gmail-style state management for reliable duplicate prevention.

Configuración

drive_pathstring
The path in OneDrive to monitor for changes. Default is root.
include_deletedboolean
Whether to include deleted items in the changes
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

event_typestringObligatorio
Type of change event (created, modified, deleted)
itemobjectObligatorio
The OneDrive item that changed

Instrucciones

**Instructions for Setting Up the Trigger:** - Ensure that OneDrive API access is configured for your account. - This trigger will monitor for newly created files in your OneDrive. - Use `include_folders` to also detect folder creation events. - The trigger uses timestamp filtering and duplicate prevention like Gmail triggers.

File UpdatedONE_DRIVE_FILE_UPDATEDTrigger

Trigger that fires when a OneDrive file's content or metadata changes. Returns file ID, last modified time, and modifier info.

Configuración

drive_pathstring
The path in OneDrive to monitor for file updates. Use '/' for root or a subpath like 'Documents/Reports'.
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

file_idstringObligatorio
The ID of the updated file
last_modified_timestring
The ISO8601 timestamp when the file was last modified
modified_byobject
Information about who last modified the file

Instrucciones

Monitors your OneDrive for file updates in the specified path. Configure 'drive_path' to a folder path (e.g., '/','Documents', 'Documents/Reports'). On the first run, the trigger initializes state and returns no events.

OneDrive Folder Created TriggerONE_DRIVE_FOLDER_CREATED_TRIGGERTrigger

Triggers when a new folder is created in OneDrive. Uses Gmail-style state management for reliable duplicate prevention.

Configuración

drive_pathstring
The path in OneDrive to monitor for changes. Default is root.
include_deletedboolean
Whether to include deleted items in the changes
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

event_typestringObligatorio
Type of change event (created, modified, deleted)
itemobjectObligatorio
The OneDrive item that changed

OneDrive Item Deleted TriggerONE_DRIVE_ITEM_DELETED_TRIGGERTrigger

Triggers when a file or folder is deleted in OneDrive. Uses Gmail-style state management for reliable duplicate prevention.

Configuración

drive_pathstring
The path in OneDrive to monitor for changes. Default is root.
include_deletedboolean
Whether to include deleted items in the changes
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

event_typestringObligatorio
Type of change event (created, modified, deleted)
itemobjectObligatorio
The OneDrive item that changed

Item Moved or RenamedONE_DRIVE_ITEM_MOVED_OR_RENAMED_TRIGGERTrigger

Triggers when a file or folder is moved to a different path or renamed in OneDrive. Includes both old and new path/name data in the payload.

Configuración

drive_pathstring
The path in OneDrive to monitor for moves/renames. Default is root.
include_filesboolean
Whether to include files in move/rename detection.
include_foldersboolean
Whether to include folders in move/rename detection.
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

event_typestringObligatorio
Event type: renamed, moved, or moved_and_renamed
item_idstringObligatorio
The unique identifier of the item
item_typestringObligatorio
Type of the item: file or folder
new_namestring
Current name of the item
new_pathstring
Current parentReference.path of the item
old_namestring
Previous name of the item
old_pathstring
Previous parentReference.path of the item
payloadobject
Full OneDrive payload
web_urlstring
Web URL of the item

Instrucciones

This trigger monitors OneDrive for items that are moved to a different folder path or renamed. - Configure drive_path to scope monitoring to a specific folder (default is root "/"). - Choose whether to include files and/or folders via include_files/include_folders. - The payload contains old and new name/path values for precise change handling.

OneDrive Item Updated TriggerONE_DRIVE_ITEM_UPDATED_TRIGGERTrigger

Triggers when an existing file or folder is modified in OneDrive. Uses Gmail-style state management and only detects actual modifications, not new creations.

Configuración

drive_pathstring
The path in OneDrive to monitor for changes. Default is root.
include_deletedboolean
Whether to include deleted items in the changes
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes

Payload del evento

event_typestringObligatorio
Type of change event (created, modified, deleted)
itemobjectObligatorio
The OneDrive item that changed

New Version CreatedONE_DRIVE_NEW_VERSION_CREATED_TRIGGERTrigger

Trigger that fires when a new version of a specified OneDrive file is created.

Configuración

drive_idstring
The unique identifier of the drive. Optional; defaults to /me if not provided.
group_idstring
The unique identifier of the group. Mutually exclusive with other scope IDs.
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes
item_idstringObligatorio
The unique identifier of the OneDrive file to monitor.
site_idstring
The unique identifier of the site. Mutually exclusive with other scope IDs.
user_idstring
The unique identifier of the user. Mutually exclusive with other scope IDs.

Payload del evento

item_idstringObligatorio
The ID of the OneDrive file.
modified_timestringObligatorio
The ISO 8601 timestamp of when this version was last modified.
version_numberstringObligatorio
The version number/ID as returned by Microsoft Graph (e.g., '2.0').

Instrucciones

Monitors a specific OneDrive file for new versions. Provide the file's item_id (and optionally drive/group/site/user scope). On the first run (last_synced_at == 0), no events are emitted; the state initializes.

Sharing Permission Added or RemovedONE_DRIVE_SHARING_PERMISSION_CHANGED_TRIGGERTrigger

Sharing Permission Added or Removed

Configuración

drive_idstring
Drive ID if monitoring an item outside the signed-in user's default drive.
group_idstring
Group ID if the item resides in a group's drive.
include_role_updatesboolean
If true, the trigger will also fire when roles are changed on an existing permission (e.g., from read to write).
intervalnumber
Periodic Interval to Check for Updates & Send a Trigger in Minutes
item_idstring
The unique identifier of the OneDrive item to monitor for permission changes.
item_pathstring
Alternative to item_id. Path relative to drive root in the form ':/path/to/item:/'
site_idstring
SharePoint Site ID if the item resides in a site's drive.
user_idstring
User ID if the item resides in a specific user's drive.

Payload del evento

affected_identitiesobject[]
Users/groups/apps affected by this change
event_typestringObligatorio
permission_added | permission_removed | permission_updated
item_idstringObligatorio
The OneDrive item ID whose sharing changed
linkobject
Sharing link details, if any
permission_idstringObligatorio
The permission ID involved in the change
previous_rolesstring[]
The roles before the change (for updated)
rolesstring[]
The roles after the change (for added/updated)

Instrucciones

Monitor a specific OneDrive item for sharing permission changes. Provide the item_id (or item_path with drive context). On first run, the trigger initializes state and emits no events. On subsequent polls, it detects permissions added or removed. Optionally, enable include_role_updates to also detect role changes.