Add Attachment to List Item
Tool to add an attachment to a SharePoint list item. Use when you need to upload a binary file as an attachment to a specified list item.
SharePoint is a Microsoft platform for document management and intranets, enabling teams to collaborate, store, and organize content securely and effectively
Tool to add an attachment to a SharePoint list item. Use when you need to upload a binary file as an attachment to a specified list item.
DEPRECATED: Use SHARE_POINT_ENSURE_USER instead (supports email param directly). Adds an existing Azure AD user to the SharePoint site collection using the ensureuser endpoint. This action is idempotent - if the user is already in the site, it returns their existing details without error.
Add one existing field to a SharePoint list's default view. This changes view membership but does not create or modify the field itself.
Tool to add a field link to a list content type. Use when you want to associate an existing list field with a content type.
Add a SharePoint role assignment to a file or folder selected by server-relative path after role inheritance has been broken. This visibly changes who can access the document; obtain explicit human approval for the target path, principal_id, and role_definition_id before executing.
Tool to add a role assignment to a list item. Use when granting specific permissions to a user or group after breaking inheritance if needed. This action is externally visible and permanently alters item permissions; obtain explicit human approval for the target item and `role_definition_id` before executing.
Tool to add a role assignment to a SharePoint list. Requires the list to have broken role inheritance first via SHARE_POINT_BREAK_ROLE_INHERITANCE_ON_LIST; inheriting lists will reject unique role assignments. Use when granting permissions to a user or group on a specific list.
Apply a modern JSON theme definition to a SharePoint site.
Breaks permission inheritance on a SharePoint list, allowing you to set unique permissions. When you break inheritance, you can choose to: - Copy parent permissions as a starting point (copy_role_assignments=true) - Start fresh with no inherited permissions (copy_role_assignments=false) - Clear unique permissions on child items to re-inherit from this list (clear_subscopes=true) Use this when you need to manage list-level permissions independently from the site. Must be called before SHARE_POINT_ADD_ROLE_ASSIGNMENT_TO_LIST, which fails on lists still inheriting from the parent site.
Tool to break permission inheritance on a list item. Call this before adding new role assignments; adding assignments prior leaves the item still inheriting parent permissions, causing unexpected access behavior. Use when you need to uniquely set permissions on an item after copying or clearing parent assignments.
Tool to check if the current user is following a specified actor. Use when verifying follow status before performing follow or unfollow operations.
Tool to check in a file. Use after uploading or editing a document and you're ready to finalize changes.
Tool to check out a file in a document library. Use when you need to lock a file before making changes.
Check out a modern SharePoint page by its positive Site Pages list-item ID.
Remove every field from a SharePoint list's default view without deleting the fields themselves. This is a destructive view-configuration operation; use it only when the entire current default-view layout should be cleared.
Update a SharePoint list view's title, CAML query, row limit, or visible fields, then read back the resulting configuration. At least one mutation is required.
Start an asynchronous copy of a drive item and return Microsoft's monitor URL. A successful call means the copy was accepted, not completed; inspect the monitor outside this action until it reports completed or failed.
Creates a SharePoint site content type with a name and optional description, group, and ID for use with lists or libraries.
Create a folder beneath a path-addressed parent in a SharePoint document-library drive.
Tool to create a sharing link for a drive item in SharePoint or OneDrive. Use when you need to generate a shareable link with specific permissions (view/edit/embed) and scope (anonymous/organization/users). The link can optionally include password protection and expiration date.
Create a resumable upload session for a new file and return its preauthenticated upload URL.
Tool to create a list item in a specific folder within a SharePoint list. IMPORTANT: This action works ONLY with SharePoint lists (not document libraries). The folder_url can be either a server-relative URL (e.g., '/Lists/MyList') or an absolute URL (e.g., 'https://site.sharepoint.com/sites/sitename/Lists/MyList'). To create files in document libraries, use a different action like upload_file.
Add a navigation link to the selected SharePoint site's Quick Launch collection.
Create a folder in a SharePoint document library and return its server-relative URL; if the folder already exists, the action can return the existing folder instead. It does not configure sharing or permissions.
Creates a SharePoint list from a specified template, name, and optional description. Returns a creation message, list ID, title, and description; custom columns are not supplied at creation.
Tool to create a new field (column) in a SharePoint list. Use when you need to programmatically add a column after confirming the list GUID.
Create a SharePoint list field from native Field XML and AddFieldOptions flags.
Creates a new item in a SharePoint list selected by title. Returns the created item data along with a separate item ID and creation timestamp.
Tool to create a new item in a SharePoint list using the list's GUID. Use when you have the list GUID rather than the list title.
Create a view in a SharePoint list selected by GUID or exact title. Optional view settings are sent only when provided.
Create a child link beneath an existing SharePoint navigation node.
Start provisioning a modern communication or non-group team site collection and return its initial provisioning status; status 1 is not yet ready.
Create a reusable web-level SharePoint field (site column) in the selected site. Use the returned field GUID and internal name when attaching or updating the site column.
Create a reusable site-scoped SharePoint field from complete field schema XML.
Tool to create a new SharePoint subsite under the current site. Use when you need to create a new subsite with specific settings for permissions, language, and template.
Create an unpublished Article-layout modern SharePoint site page draft.
Tool to delete content for a specific version of a drive item in SharePoint. Use when you need to remove the binary content associated with a particular version of a file while keeping the version metadata.
Tool to delete multiple SharePoint list items in bulk. Use when you need to permanently remove multiple items by their IDs. This action is irreversible - deleted items cannot be recovered. For recoverable deletion, use the recycle action instead. Use this action when you have a list of item IDs to delete from the same list.
Tool to permanently delete a SharePoint Recycle Bin item. Use after confirming the item's GUID to remove it irrevocably.
Move a drive item selected by drive and item IDs to the SharePoint recycle bin.
Delete a SharePoint document library file by server-relative path. An optional ETag controls conditional deletion; the default wildcard deletes regardless of version.
Deletes a SharePoint document library folder by its server-relative path. An ETag can be supplied for conditional deletion.
Tool to delete a SharePoint list. Use when you need to remove a list by its GUID after confirming the correct list identifier.
Tool to delete a SharePoint list by its title. Use when you need to permanently remove a list and all its contents by specifying the list name.
Delete one field, identified by canonical field GUID, from an explicitly selected SharePoint list. This permanently changes that list's schema.
Tool to delete a SharePoint list item. Use when you need to permanently remove an item by its ID. Use after obtaining the item's ETag to ensure concurrency control.
Tool to download a file by server-relative URL. Use when you need to fetch the raw bytes of a SharePoint file by its server-relative path.
Tool to download an attachment from a SharePoint list item. Use when retrieving the binary contents of a specific attachment after confirming the list title, item ID, and filename.
Ensure a user exists in a SharePoint site using a login name or email, returning their user information. This write operation may register the user and optionally update their display name, but does not assign permissions.
Look up a user in a SharePoint site by email and return available user details. Check user_exists and error_message together: lookup errors can also produce user_exists=false.
Follow a SharePoint user, document, site, or tag. Use to make the authenticated user follow a specified actor. Supports following users (actor_type=0), documents (actor_type=1), sites (actor_type=2), or tags (actor_type=3).
Retrieves folders from a SharePoint web for site discovery. Supports OData filtering, field selection, expansion, sorting, and a result limit; the response does not expose a continuation token.
Retrieves a SharePoint site content type by ID, including its metadata and available form properties.
Retrieves a SharePoint list content type by list ID and content type ID, returning its metadata and any schema or fields supplied in the response. Fields may be deferred rather than expanded.
Tool to retrieve all content types for a specific SharePoint list by GUID. Use when you need the content type IDs, names, and descriptions of every content type in a list.
Tool to retrieve the current user for the site. Use after authenticating to get the current SharePoint user. A successful response confirms authentication only; access to specific sites, lists, or libraries depends on separate scopes and item-level permissions.
Resolve and return the connected user's default OneDrive using delegated authentication.
Get the root drive item of a SharePoint site's default document library.
Get one SharePoint or OneDrive drive by its drive ID from the selected site endpoint.
Tool to get analytics for a SharePoint drive item. Use when you need to retrieve access statistics (view counts, unique viewers) for files or folders in SharePoint/OneDrive.
Get metadata for one file or folder by drive ID and item ID from a SharePoint site or provider-derived OneDrive for Business personal-site URL.
Get a file or folder from a site's default document library by its drive-root-relative path.
Return one page of drive-item changes and the opaque next or delta link. Use token='latest' to obtain a checkpoint without enumerating existing items, then pass a returned continuation URL back unchanged.
Retrieve thumbnail URL and dimension sets for a default-drive item by path.
Fetch SharePoint file metadata by server-relative path using the ServerRelativePath API, without downloading file content. This deprecated action returns an existence flag and available file properties such as URL and unique ID.
Tool to get entities the current user is following. Use when you need to retrieve followed users, documents, sites, or tags after authentication.
Lists users in a SharePoint group by name, returning a page of user information. Supports OData filtering, sorting, field selection, and pagination using top and skip.
Lists users in a SharePoint site group by numeric group ID, returning a page of user information. Supports OData filtering, sorting, field selection, and pagination using top and skip.
Tool to retrieve a SharePoint list item by ID. Use when you need to fetch a specific item after knowing its ID.
Tool to retrieve a specific version of a SharePoint list item. Use when you need to access historical versions of list items.
Retrieves the list of users who are following the authenticated user in SharePoint. Returns an array of SocialActor objects containing follower details like name, email, account name, and personal site URI. No parameters required - automatically retrieves followers for the current authenticated user.
Tool to list role definitions at the web level. Role definition IDs and names are scoped per web/site collection — never hard-code them, as admins can modify role sets and IDs differ across site collections. Always resolve current values dynamically via this tool.
Access a shared SharePoint file or folder by share ID or encoded sharing URL without granting lasting access.
Tool to retrieve SharePoint context information including the form digest value. Use when you need a form digest token for write operations (POST, PUT, DELETE).
Deprecated: retrieves SharePoint folder metadata by server-relative URL. Expanded immediate subfolders are returned in the Folders array and can be retrieved individually to traverse nested structures.
Tool to retrieve a SharePoint list by its GUID. Use when you need to fetch list metadata by its unique identifier. Prefer over name-based lookup tools when the GUID is known, as names may collide across similarly named lists.
Tool to retrieve a SharePoint list by its title. Use when you need to fetch list metadata by title.
Tool to retrieve changes from SharePoint list change log. Use when processing webhook notifications to get actual changes that occurred. Set boolean flags in query (Add, Item, Update, etc.) to filter change types. Store the ChangeToken from the last change and use as ChangeTokenStart in subsequent calls to track only new changes.
Get one field definition from a SharePoint list by field GUID or exact internal name/title.
Tool to retrieve items from a SharePoint list. Use when you need to fetch list entries with optional OData parameters.
Tool to retrieve items from a SharePoint list using its GUID. Use when you have the list's unique identifier and need to fetch list entries with optional OData parameters.
Retrieves metadata about the root web of a SharePoint site collection. Use this action when you need to get information about the root site in a site collection, such as its title, URL, language settings, or template information. This is useful for discovering the top-level site properties before navigating to subsites or performing collection-wide operations.
Retrieve SharePoint site information by hostname or URL. Returns site metadata including site ID, display name, URLs, and timestamps. Use this action when you need to discover a site's identifier or properties using only its hostname, which is essential for subsequent operations requiring siteId. Useful for validating site existence or obtaining site metadata without prior knowledge of internal IDs.
Retrieve metadata for a SharePoint site web by its GUID within the selected site collection, such as its title, URL, language, or template information.
Fetch metadata for the selected SharePoint site collection, including its URL, ID, and root web information.
Retrieve one web-scoped SharePoint field by its GUID. Use select to limit the returned field metadata to specific properties.
Tool to retrieve modern SharePoint Site Pages content by reading list item fields. Use when a .aspx page result cannot be downloaded as a file or when you need the structured content (CanvasContent1, LayoutWebpartsContent) of modern pages.
Get the regional time-zone definition for a selected SharePoint site.
Tool to retrieve information about the current SharePoint web (site) using REST API. Use when you need web metadata such as title, URL, language, or template information.
Tool to retrieve a specific webhook subscription by ID from a SharePoint list. Use when you need to check subscription details like expiration date or notification URL.
Tool to retrieve all webhook subscriptions on a SharePoint list. Use when you need to view existing webhook configurations for a list.
Retrieves all content types from the current SharePoint site. Use this action to discover available content types on a SharePoint site. Returns metadata for each content type including Id, Name, Description, Group, and other properties. Supports OData query parameters for filtering, selecting specific fields, sorting, and pagination.
Tool to retrieve a file or folder by its server-relative path in a SharePoint site. Use when you need to get metadata for an item (file or folder) by path.
Get a user's effective permissions on the current SharePoint site (Web). This action retrieves the combined permissions a user has on the site, taking into account direct permissions, group memberships, and permission inheritance. Use this when you need to verify what permissions a user or group has before performing operations. The response contains permission masks as 64-bit integers split into high and low 32-bit values. A value of "0" for both means no permissions. Returns site-level permissions only; list-level or item-level grants and restrictions are not reflected.
Inspect deployment and package metadata for one SharePoint app.
List the field internal names currently displayed in a SharePoint list's default view. Use this before adding or clearing default-view fields, and use SHARE_POINT_LIST_LIST_COLUMNS when full field definitions are needed.
List a page of files and folders in a SharePoint drive's root or a specified folder using REST API v2.0. The response may include a next-page link.
List effective sharing permissions for one drive item. This returns drive-item sharing/link permissions, not SharePoint web role assignments; non-owners may receive only permissions that apply to them.
List retained versions of a SharePoint drive item, newest first.
Tool to retrieve drives using SharePoint REST API v2.0. Use when you need to list document libraries and drives from a SharePoint site using native SharePoint authentication (not Microsoft Graph).
List files directly within a SharePoint folder by server-relative path, without recursively enumerating subfolders. Results can be paginated using top and skip; the response does not include a continuation token.
Tool to list all attachments for a SharePoint list item. Use when you need to retrieve filenames and server-relative URLs of each attachment after confirming the list title and item ID.
List recently modified files and folders in a SharePoint drive's root, ordered by modification time. By default, collects up to the requested limit across pages; optional pagination returns one page and a continuation token.
Tool to list items in the SharePoint Recycle Bin. Use when you need to retrieve deleted items and page through results.
List a page of principals and expanded permission-level bindings on a SharePoint list or list item. The delegated user must have a permission level containing Enumerate Permissions on the selected resource; the response does not expose a continuation token.
List column definitions for a SharePoint list. First use SHARE_POINT_LIST_ALL_LISTS on the target site to obtain the list Id, then call this action with that list_id and the same site_name. Returns field metadata including column names, types, and properties.
List saved views for a SharePoint list selected by GUID or exact title, with optional OData projection, filtering, sorting, and offset pagination.
Retrieves all lists in the current SharePoint web/site. Use this action to discover available lists and document libraries on a SharePoint site, or to pre-check for existing lists before creation (duplicate list names will fail). Returns metadata for each list including Title, Id, BaseType, ItemCount, and other properties. Supports OData query parameters for filtering, selecting specific fields, sorting, and pagination.
List transcript metadata for a media item in the selected SharePoint site's or explicit OneDrive personal site's default drive, without downloading transcript content. This action does not support an arbitrary drive ID.
List child navigation nodes beneath a specified SharePoint navigation node.
List a site's SharePoint Quick Launch navigation nodes.
List reusable web-level SharePoint fields (site columns). Use this action to discover schema shared across lists in a selected site; use SHARE_POINT_LIST_LIST_COLUMNS for fields attached to one list.
List one provider page of modern SharePoint site pages, optionally filtering or selecting fields. This action returns next_link when more provider pages exist but does not retrieve that continuation itself.
Search for SharePoint sites accessible to the user. Returns a limited set of search results, with an optional query and result limit.
List a page of document libraries (drives) accessible in a SharePoint site, including default and custom libraries. The requested page size defaults to 25.
Tool to list SharePoint site groups for a site collection. Use when you need to see all groups and their settings before managing permissions.
Tool to list users in the site collection. Results include person users, groups, and system principals by default; use filter 'PrincipalType eq 1' to restrict to individual users.
Tool to list immediate child folders within a SharePoint folder. Use when you need folder navigation or directory discovery by server-relative URL.
List principals assigned SharePoint permission levels on a web/site, including each principal and its bound role definitions. Delegated users must have a SharePoint permission level containing Enumerate Permissions on the selected web, such as Full Control or Manage Hierarchy. Use this for SharePoint role assignments, not file sharing links.
Log a SharePoint usage analytics event for a user activity, such as a document view, edit, or custom interaction, for usage reporting.
Add, move, or remove all fields in one SharePoint list view selected by GUID or title.
Move an existing SharePoint file or folder to a new server-relative path. Set overwrite only when an item at the destination may be replaced.
Publish the latest version of a modern SharePoint site page by its positive item ID.
Execute a CAML query against a SharePoint list and return native list-item records.
Tool to move a file to the Recycle Bin. Use when you need to recycle a file after confirming its folder and filename paths.
Tool to move a list item to the Recycle Bin. Use when you need to soft-delete an item but preserve the ability to restore it.
Redeem a SharePoint sharing link and grant the connected account durable access to the shared file or folder.
Removes a user from SharePoint. Returns success even if user doesn't exist or was never a member; check response fields `was_removed` (bool) and `message` (str) to distinguish an actual removal from a no-op.
Renames a SharePoint folder by updating its list item metadata. To use this action: 1. Provide the folder path and new leaf folder name. 2. The action updates the folder list item fields needed by SharePoint. The rename operation updates both the folder's display name (Title) and actual name (FileLeafRef). Note: This only changes the folder name, not its location in the hierarchy.
Retrieve list items from SharePoint with rich metadata and formatting. Returns items in the 'Row' array along with pagination info (FirstRow, LastRow, NextHref). Supports CAML queries via ViewXml for filtering and sorting. Use this when you need list data with properly formatted field values, lookup fields, or managed metadata - more capable than standard OData endpoints.
Resolve a SharePoint sharing URL or provider share token to its underlying drive item. Provide exactly one of sharing_url or share_token.
Tool to restore a previous version of a SharePoint drive item. Use when you need to revert a file to an earlier version.
Tool to restore a SharePoint Recycle Bin item. Use when you need to recover a deleted item by providing its GUID.
Search for files across all SharePoint sites and OneDrive using Keyword Query Language. Returns files matching the query with metadata like title, path, size, author, and modification time. Use this action when you need to discover files broadly across an organization without knowing specific drive IDs or site locations. Results are automatically filtered to show only document content types. A site_name changes the endpoint context but does not isolate results unless restrict_to_site_path is enabled or query contains an equivalent Path restriction. Use from_index and row_limit parameters to paginate through large result sets.
Search SharePoint content using Keyword Query Language (KQL). Returns documents, list items, folders, and other content matching your query. Supports filtering by properties (file type, author, date), pagination, and custom property selection. Results are nested under PrimaryQueryResult→RelevantResults→Table→Rows→Cells as Key/Value pairs requiring explicit extraction. Results are security-trimmed: inaccessible content never appears even if it exists. Use contentclass (e.g., STS_Site, STS_Web, STS_ListItem_DocumentLibrary) in querytext to isolate specific item types. A site_name changes the endpoint context but does not isolate results unless restrict_to_site_path is enabled or querytext contains an equivalent Path restriction.
Tool to get search query suggestions. Use when you need to provide autocomplete options for user search input.
Tool to undo a file checkout, discarding any changes made while checked out. Use when you need to cancel edits and unlock the file without saving.
Update a SharePoint file or folder's name or title by server-relative path. When a name is supplied without a title, the title is also set to the new name.
Tool to update metadata fields on a SharePoint file item via its ListItemAllFields. Use this action when you need to modify document properties, custom columns, or metadata without changing the file content itself. This operates on the list item behind the file, allowing you to set Title, Status, Owner, Categories, or any other library column.
Tool to update a SharePoint content type's properties such as name, description, group, or hidden status. Use when you need to modify content type metadata.
Tool to update properties of an existing SharePoint list. Use when you need to modify list metadata such as title, description, or settings like versioning and attachments.
Update one or more mutable properties of an existing SharePoint list field identified by list and field GUID. Provide at least one of title, description, required, hidden, indexed, or enforce_unique_values. This changes the field schema for the selected list.
Update fields on an existing SharePoint list item via MERGE. An ETag can be supplied for concurrency control; the default wildcard updates regardless of version.
Tool to update properties of the current SharePoint site (web). Use when you need to modify site title, description, or other SP.Web properties via MERGE.
Update mutable properties of an existing SharePoint site field by GUID, changing reusable web-level schema for the selected site. Enabling unique values also enables indexing when indexing is omitted.
Rename or move a SharePoint site drive item, or set its client file-system timestamps, and return the updated item.
Upgrade an installed SPFx solution from its tenant or site-collection catalog package.
Fetch a file from a URL and upload it to SharePoint. Conflict behavior can be set to replace, fail, or rename; it defaults to replace, which can overwrite an existing file.
Tool to upload a file to a SharePoint document library or folder. Use when you need to programmatically add or update a file in a document library.
Create a direct-v2 upload session and upload one file in sequential chunks.
Validate and commit document-library field values for a SharePoint file. Inspect every returned HasException and ErrorMessage because HTTP 200 can include rejected fields.
Validate SharePoint credentials by attempting to retrieve the current user information. Use this action during setup or configuration to verify that provided credentials have valid access to the SharePoint site before performing other operations.
The SharePoint integration connects your Dench AI CRM directly to SharePoint, so agents can read and act on your SharePoint data as part of everyday work — answering questions in chat, keeping your CRM in sync, and running automations without anyone copying data between tools.
152 actions are available for agents to invoke on your behalf. Every call runs through SharePoint's own authorization, scoped to the account you connect.
Sign in to your Dench workspace and open Integrations.
Find SharePoint and click Connect — you'll authorize access through SharePoint's own sign-in flow. No API keys or code required.
Ask an agent to use SharePoint in chat, or call it from an automation.
Manage or disconnect the connection any time from workspace settings.
The Dench SharePoint integration connects your AI CRM to SharePoint, so AI agents can work with your SharePoint data as part of chats, automations, and CRM workflows. You connect your account once, and every agent in your workspace can use it — governed by your workspace permissions.
The SharePoint integration currently exposes 152 actions, including Add Attachment to List Item, Add Azure AD User to SharePoint Site (Deprecated), Add Default View Field, Add Field Link to Content Type, Add Role Assignment to Document by Path, and Add Role Assignment to List Item. Agents invoke them on your behalf from chat or from automations.
No. You connect SharePoint from your Dench workspace using SharePoint's own sign-in and authorization flow — no API keys to copy, no glue code to maintain.
Connections are authorized through SharePoint's own authentication flow, and Dench stores only the authorization needed to act on your behalf. You can review and disconnect the SharePoint connection from your workspace settings at any time.