SharePoint
Your Toolhouse AI Worker can connect to Share Point using 89 specialized tools.
Auth Connection
This service requires an auth connection to use its tools. You can set this up in your Toolhouse dashboard under Auth Connections.
Tools (89)
Share Point Add Attachment To List Item
Share Point Add Attachment To List ItemIntegration name: SHARE_POINT_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
item_id
integer
✅
1
ID of the list item to which the file will be attached.
file_name
string
✅
"example.pdf"
Name to assign to the attachment file in SharePoint.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
"Announcements"
The display title of the SharePoint list containing the target item.
content_text
string
—
Optional raw text content to upload (UTF-8 encoded). Use when not passing file_content.
file_content
object
—
File to attach. Alternatively, omit this and provide either 'content_text' for UTF-8 text or 'content_base64' for arbitrary bytes.
content_base64
string
—
Optional base64-encoded bytes to upload. Use for binary content when not passing file_content.
Share Point Add Field Link To Content Type
Share Point Add Field Link To Content TypeIntegration name: SHARE_POINT_ADD_FIELD_LINK_TO_CONTENT_TYPE
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
hidden
boolean
—
Whether the field link should be hidden in forms. Defaults to False.
listid
string
✅
"01234567-89ab-cdef-0123-456789abcdef"
GUID of the SharePoint list in canonical format, e.g., '01234567-89ab-cdef-0123-456789abcdef'.
required
boolean
—
Whether the field link should be required. Defaults to False.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
contenttypeid
string
✅
"0x0100CC8BDE8AF72FC745A823106B7E8CD1FF"
The content type ID (StringValue) within the list, e.g., '0x0100CC8BDE8AF72FC745A823106B7E8CD1FF'.
field_internal_name
string
✅
—
The internal name of the existing field to link (e.g., 'Title').
Share Point Add Role Assignment To Item
Share Point Add Role Assignment To ItemIntegration name: SHARE_POINT_ADD_ROLE_ASSIGNMENT_TO_ITEM
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
item_id
integer
✅
1
ID of the list item to which to add the role assignment.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
"My Documents"
Title of the SharePoint list containing the target item. Must exactly match the list's display name.
principal_id
integer
✅
15
ID of the user or group to grant permissions.
role_definition_id
integer
✅
1073741827
ID of the permission level (role definition) to assign.
Share Point Add Role Assignment To List
Share Point Add Role Assignment To ListIntegration name: SHARE_POINT_ADD_ROLE_ASSIGNMENT_TO_LIST
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
—
The title of the SharePoint list to grant permissions on.
principal_id
integer
✅
—
The ID of the user or group principal to which the role will be assigned. Must be a site-collection-registered ID; use the Id returned by SHARE_POINT_ENSURE_USER to avoid invalid-principal errors.
role_definition_id
integer
✅
—
The ID of the role definition to assign (e.g., 1073741827 for Contribute).
Share Point Break Role Inheritance On Item
Share Point Break Role Inheritance On ItemIntegration name: SHARE_POINT_BREAK_ROLE_INHERITANCE_ON_ITEM
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
item_id
integer
✅
—
ID of the list item whose permissions inheritance will be broken
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
—
Title of the list containing the item Must be the exact display name as shown in SharePoint UI, not the URL segment or internal name.
clear_subscopes
boolean
—
Whether to clear unique permissions on any child scopes of the item
copy_role_assignments
boolean
—
Whether to copy existing parent role assignments to the item before breaking inheritance
Share Point Break Role Inheritance On List
Share Point Break Role Inheritance On ListIntegration name: SHARE_POINT_BREAK_ROLE_INHERITANCE_ON_LIST
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
—
The title of the SharePoint list to break permission inheritance on.
clear_subscopes
boolean
✅
—
Whether to reset unique permissions on child items (folders, documents) to inherit from this list. Set true to remove all item-level custom permissions and force inheritance from the list. Set false to preserve existing item-level unique permissions.
copy_role_assignments
boolean
✅
—
Whether to copy parent permissions when breaking inheritance. Set true to start with a copy of the parent site's permissions (recommended for most cases). Set false to start with empty permissions where only the current user has access.
Share Point Check In File
Share Point Check In FileIntegration name: SHARE_POINT_CHECK_IN_FILE
Tool to check in a file. Use after uploading or editing a document and you're ready to finalize changes.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
comment
string
"Initial check-in"
Check-in comment to describe this version of the file. Defaults to empty string if not provided.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
checkintype
integer
0
Check-in type: 0=MinorCheckIn (draft/minor version), 1=MajorCheckIn (published/major version), 2=OverwriteCheckIn (overwrite current version without creating new version). Defaults to 1 (Major version).
server_relative_path
string
✅
"/Shared Documents/example.docx"
Server-relative URL of the file to check in, including library and folders. E.g., '/Shared Documents/example.docx'.
Share Point Create Content Type
Share Point Create Content TypeIntegration name: SHARE_POINT_CREATE_CONTENT_TYPE
Tool to create a new content type in SharePoint. Use when you need to define a custom content type with specific metadata structure for lists or libraries.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
id
object
—
Model for the content type ID value object.
name
string
✅
"TestContentType2"
The name of the content type to create.
group
string
"Custom Content Types"
The group category for the content type, e.g., 'Custom Content Types', 'Document Content Types'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
description
string
"Another test content type"
Description of the content type. Provides context about the purpose and usage of this content type.
Share Point Create Drive Item Sharing Link
Share Point Create Drive Item Sharing LinkIntegration name: SHARE_POINT_CREATE_DRIVE_ITEM_SHARING_LINK
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
type
string
✅
—
The type of sharing link to create. 'view' creates read-only access, 'edit' creates read-write access, 'embed' creates embeddable link (OneDrive Personal only).
scope
string
—
Scope of the sharing link.
drive_id
string
✅
"b!sAYRj4psj0qqpjB3OOHdglZBMF5Nk0xPnR4Fc4pfinI7DA8OPuKvSo4igDo7VyMV"
The unique identifier of the drive containing the item.
password
string
—
The password for the sharing link. Optional and OneDrive Personal only.
driveItem_id
string
✅
"01K67O4VQJ6LBMI64JF5FLHHIQ4OJP45SP"
The unique identifier of the drive item to create a link for.
expirationDateTime
string
"2024-12-31T23:59:59Z"
The expiration time of the sharing link in ISO 8601 format (yyyy-MM-ddTHH:mm:ssZ). If not specified, the link does not expire unless a default expiration policy is enforced.
retainInheritedPermissions
boolean
—
If true (default), any existing inherited permissions are retained on the shared item. If false, all existing permissions are removed when sharing for the first time.
Share Point Create List Field
Share Point Create List FieldIntegration name: SHARE_POINT_CREATE_LIST_FIELD
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
title
string
✅
"My Column"
Display name of the new list field.
required
boolean
—
Whether the field is required (non-nullable).
list_guid
string
✅
"01234567-89ab-cdef-0123-456789abcdef"
GUID of the SharePoint list where the new field will be created. Obtain via SHARE_POINT_SHAREPOINT_CREATE_LIST or SHARE_POINT_GET_LIST_BY_TITLE before calling this tool.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
static_name
string
✅
"MyColumnInternal"
Internal name of the field (no spaces).
field_type_kind
integer
✅
2
Numeric value from SP.FieldType enumeration specifying the type of the field. Common values: 1=Counter, 2=Text (single line), 3=Note (multiple lines), 6=Choice, 8=Boolean, 9=Number (decimal), 11=URL, 20=User.
enforce_unique_values
boolean
—
Whether values in this field must be unique. When True, the field will automatically be marked as Indexed, which SharePoint requires for unique-value enforcement.
Share Point Create List Item By Id
Share Point Create List Item By IdIntegration name: SHARE_POINT_CREATE_LIST_ITEM_BY_ID
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
fields
object
✅
{"Title":"New Task","Status":"Active"}
Dictionary mapping internal field names to their values for the new list item. Example: {'Title': 'New Item', 'Description': 'Item details'}. At minimum, provide 'Title' field for most lists.
list_id
string
✅
"a12e3d6e-9414-462d-bd53-cf06f3982ad3"
The unique identifier (GUID) of the SharePoint list where the item will be created. Format: '12345678-1234-1234-1234-123456789abc'
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
metadata_type
string
✅
"SP.Data.TasksListItem"
The ListItemEntityTypeFullName required for __metadata.type in the request body. Format: 'SP.Data.{ListName}ListItem' (e.g., 'SP.Data.TasksListItem' or 'SP.Data.AbcListItem'). Use GET_LIST_ITEM_ENTITY_TYPE_FULL_NAME to retrieve this value if unknown.
Share Point Create List Item In Folder
Share Point Create List Item In FolderIntegration name: SHARE_POINT_CREATE_LIST_ITEM_IN_FOLDER
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
values
array
✅
—
List of field name/value pairs to set on the new item.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the tenant is derived from the connected account's base URL.
folder_url
string
✅
"/Lists/MyList"
URL of the target folder within the list where the item will be created. Accepts both server-relative URLs (e.g., '/Lists/MyList') and absolute URLs (e.g., 'https://site.sharepoint.com/sites/sitename/Lists/MyList'). For the list root folder, use '/Lists/' or the full absolute URL. For a subfolder within the list, append the subfolder path. You can obtain this URL from the list's RootFolder.ServerRelativeUrl property. This parameter works with SharePoint lists only, NOT document libraries.
list_title
string
✅
"MyList"
The title of the SharePoint list where the item will be created. Must be an existing list (not a document library).
check_in_comment
string
—
Optional check-in comment if the item is checked out.
Share Point Create Web
Share Point Create WebIntegration name: SHARE_POINT_CREATE_WEB
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
url
string
✅
—
The URL segment for the new subsite (e.g., 'TestSubWeb'). This becomes part of the site URL path. Must contain only letters, numbers, hyphens, and underscores.
title
string
✅
—
The display title for the new subsite.
language
integer
—
Language code for the subsite. Default is 1033 (English - United States). Examples: 1031 (German), 1033 (English), 1036 (French), 1040 (Italian), 1041 (Japanese), 1042 (Korean), 1043 (Dutch), 2052 (Chinese - Simplified), 3082 (Spanish).
site_name
string
—
The subsite name to scope the request to. You can find this in your SharePoint URL after /sites/ (e.g., https://tenant.sharepoint.com/sites/). If omitted, the root site is used.
description
string
—
A description of the new subsite (optional).
web_template
string
—
Web template to use for the subsite. Use 'sts' for modern team site homepage or 'sts#0' for classic team site. Other options include 'blog', 'wiki', etc.
use_unique_permissions
boolean
—
If true, the subsite will have unique permissions separate from the parent site. If false, it inherits permissions from the parent site.
Share Point Delete Drive Item Version Content
Share Point Delete Drive Item Version ContentIntegration name: SHARE_POINT_DELETE_DRIVE_ITEM_VERSION_CONTENT
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
drive_id
string
✅
"b!sAYRj4psj0qqpjB3OOHdglZBMF5Nk0xPnR4Fc4pfinI6LsO0Ty3NT6hz1n27BFpo"
The unique identifier of the drive. This is the ID of the document library or drive where the item is stored. You can get this from drive listing endpoints.
driveitem_id
string
✅
"01K67O4VSVYSGCL3MHHNDIESCQSPJ6CCZP"
The unique identifier of the drive item (file or folder). This is the ID of the specific item whose version content you want to delete.
driveitemversion_id
string
✅
"24.0"
The unique identifier of the version. Version IDs are typically numeric strings like '1.0', '2.0', '24.0', etc. You can retrieve version IDs by listing versions for a drive item.
Share Point Delete Folder
Share Point Delete FolderIntegration name: SHARE_POINT_DELETE_FOLDER
Deletes a folder from a SharePoint document library. This action permanently removes the specified folder and moves it to the site's recycle bin. Use this when you need to remove folders that are no longer needed. The operation is idempotent - attempting to delete a non-existent folder will succeed without error. Requires the server-relative path of the folder (e.g., '/Shared Documents/FolderName').
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
etag
string
"*"
ETag for conditional deletion. Use '*' (default) to delete regardless of version. Provide a specific ETag value to delete only if the folder hasn't been modified since that version.
site_name
string
—
The subsite name to scope the request to (e.g., composio-test). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
server_relative_url
string
✅
"/Shared Documents/Folder1"
The server-relative path of the folder to delete. This is the full path from the site root, including the document library and any parent folders. Format: '/DocumentLibrary/ParentFolder/FolderName'. Examples: '/Shared Documents/Reports', '/Documents/2024/Q1'.
Share Point Delete List
Share Point Delete ListIntegration name: SHARE_POINT_DELETE_LIST
Tool to delete a SharePoint list. Use when you need to remove a list by its GUID after confirming the correct list identifier.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
if_match
string
—
ETag for concurrency control; use '*' to delete regardless of version.
list_guid
string
✅
—
The GUID of the SharePoint list to delete (format: 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx').
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
Share Point Delete List By Title
Share Point Delete List By TitleIntegration name: SHARE_POINT_DELETE_LIST_BY_TITLE
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
if_match
string
—
ETag for concurrency control. Use '*' to force delete regardless of version, or provide a specific ETag value for version checking.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
"TestListToDelete"
The title of the SharePoint list to delete. This is a destructive operation that permanently removes the list and all its contents.
Share Point Delete List Item
Share Point Delete List ItemIntegration name: SHARE_POINT_DELETE_LIST_ITEM
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
item_id
integer
✅
—
Numeric ID of the list item to delete
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
—
The exact title of the SharePoint list containing the item to delete
match_etag
string
—
ETag value for concurrency control. Use '*' to force delete regardless of version. If providing a specific ETag, use the full quoted value returned by GET_LIST_ITEM_ETAG (e.g., '"guid,version"' format like '"c7a93369-bda8-4da1-b1a3-3d87d2e207fc,1"'). Simple version numbers like '1' are not valid ETags.
Share Point Delete Recycle Bin Item Permanent
Share Point Delete Recycle Bin Item PermanentIntegration name: SHARE_POINT_DELETE_RECYCLE_BIN_ITEM_PERMANENT
Tool to permanently delete a SharePoint Recycle Bin item. Use after confirming the item's GUID to remove it irrevocably.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
recyclebinitemid
string
✅
"123e4567-e89b-12d3-a456-426614174000"
GUID of the Recycle Bin item to delete permanently. Must not be empty. Retrieve this GUID by querying the recycle bin and cross-referencing item name, original path, and deletion timestamp to confirm the correct item before deletion.
Share Point Download File By Server Relative Url
Share Point Download File By Server Relative UrlIntegration name: SHARE_POINT_DOWNLOAD_FILE_BY_SERVER_RELATIVE_URL
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
"testcomposio"
Optional SharePoint site name to scope the file download. If provided, the file path is resolved relative to this site. If not provided, the site is auto-extracted from paths starting with /sites/. If not provided and no /sites/ prefix, the file path is resolved relative to the tenant root site. E.g., 'testcomposio' for a site at /sites/testcomposio.
server_relative_url
string
✅
"/Shared Documents/report.pdf"
Server-relative URL of the file to download, starting with '/'. Can be either URL-encoded or unencoded. E.g., '/Shared Documents/report.pdf' for root site, '/sites/CustomerDocs/Documents/file.pdf' for subsites, or '/personal/username_domain/Documents/file.docx' for personal OneDrive sites.
Share Point Ensure User
Share Point Ensure UserIntegration name: SHARE_POINT_ENSURE_USER
Ensures a user exists in a SharePoint site by their login name. If the user already exists, returns their info; if not, adds them to the site — this is a write operation with a provisioning side effect, not a read-only presence check. Use when you need to add a user or get their user ID for permissions. The login name must be in SharePoint claims format (e.g., 'i:0#.f|membership|user@domain.com'). This action only registers the user in the site collection and does not grant any permissions. To assign list-level access, pass the returned Id field as principal_id to SHARE_POINT_ADD_ROLE_ASSIGNMENT_TO_LIST.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
email
string
"user@domain.com"
Email address of the user to add to SharePoint. Automatically converted to claims format 'i:0#.f|membership|{email}'. Either email or login_name must be provided.
title
string
—
Optional display name/title for the user in SharePoint. If provided, the user's title will be updated after ensuring them.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
login_name
string
`"i:0#.f
membership
Share Point Follow
Share Point FollowIntegration name: SHARE_POINT_FOLLOW
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).
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
tag_guid
string
—
GUID of the tag when actor_type=3.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
actor_type
integer
✅
0
Type of the actor to follow: 0=user, 1=document, 2=site, 3=tag.
content_uri
string
—
URI of the document or site when actor_type=1 or 2, e.g., 'http://server/site'.
account_name
string
—
Account name for a user when actor_type=0, in claims format, e.g., 'i:0#.f|membership|user@domain.com'.
Share Point Get All Folders
Share Point Get All FoldersIntegration name: SHARE_POINT_GET_ALL_FOLDERS
Tool to retrieve all folders in the SharePoint web. Use when you need to discover all available folders across the site. Supports OData query parameters for filtering, selecting specific fields, sorting, and pagination.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
50
OData $top to limit the number of folders returned.
expand
string
"Files,Folders"
OData $expand to include related entities such as 'Files,Folders,ListItemAllFields'.
filter
string
"ItemCount gt 0"
OData $filter to narrow results based on folder properties.
select
string
"Name,ServerRelativeUrl,ItemCount"
OData $select to specify which folder fields to return (comma-separated), e.g., 'Name,ServerRelativeUrl,ItemCount'.
tenant
string
"composio2024"
The SharePoint tenant name (e.g., 'composio2024' for composio2024.sharepoint.com). This parameter is not used; tenant information is derived from the authenticated connection.
orderby
string
"Name asc"
OData $orderby to sort results, e.g., 'Name asc' or 'TimeCreated desc'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Get Changes
Share Point Get ChangesIntegration name: SHARE_POINT_GET_CHANGES
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
query
object
✅
—
Change query parameters specifying which types of changes to retrieve. Set boolean properties to True to include specific change types (e.g., Add=True, Item=True for new items).
list_id
string
✅
"a12e3d6e-9414-462d-bd53-cf06f3982ad3"
GUID of the SharePoint list to get changes for, in canonical format, e.g., 'a12e3d6e-9414-462d-bd53-cf06f3982ad3'.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Get Content Type
Share Point Get Content TypeIntegration name: SHARE_POINT_GET_CONTENT_TYPE
Tool to retrieve a single SharePoint content type by its ID. Use when you need detailed information about a specific content type including its fields, forms, and metadata.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
content_type_id
string
✅
"0x01"
The unique identifier of the content type to retrieve. This can be the hexadecimal content type ID (e.g., '0x01' for Item, '0x0101' for Document) or the string representation. Common IDs: '0x01' (Item), '0x0101' (Document), '0x0120' (Folder).
Share Point Get Content Types
Share Point Get Content TypesIntegration name: SHARE_POINT_GET_CONTENT_TYPES
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
10
OData $top to limit the number of results.
expand
string
"Fields"
OData $expand to include related entities.
filter
string
"Hidden eq false"
OData $filter to narrow results, e.g., 'Hidden eq false'.
select
string
"Name,Id,Description"
OData $select to specify which content type fields to return, e.g., 'Name,Id,Description'.
orderby
string
"Name asc"
OData $orderby to sort results, e.g., 'Name asc'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
skiptoken
string
"Paged=TRUE&p_ID=15"
OData $skiptoken for paging through results.
Share Point Get Content Types For List
Share Point Get Content Types For ListIntegration name: SHARE_POINT_GET_CONTENT_TYPES_FOR_LIST
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
list_guid
string
✅
"01234567-89ab-cdef-0123-456789abcdef"
GUID of the SharePoint list to retrieve content types for, in canonical format, e.g., '01234567-89ab-cdef-0123-456789abcdef'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
Share Point Get Context Info
Share Point Get Context InfoIntegration name: SHARE_POINT_GET_CONTEXT_INFO
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).
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
—
The subsite name to scope the request to (e.g., composio-test). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Get Current User
Share Point Get Current UserIntegration name: SHARE_POINT_GET_CURRENT_USER
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
—
The subsite name to scope the request to (e.g., composio-test). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Get Drive Item Analytics
Share Point Get Drive Item AnalyticsIntegration name: SHARE_POINT_GET_DRIVE_ITEM_ANALYTICS
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
drive_id
string
✅
"b!your_drive_id_here"
The unique identifier of the drive containing the item.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
time_range
string
"allTime"
Time range for analytics data. Use 'allTime' for all-time statistics or 'lastSevenDays' for the last seven days.
drive_item_id
string
✅
"01K67O4VQJ6LBMI64JF5FLHHIQ4OJP45SP"
The unique identifier of the drive item to get analytics for.
Share Point Get File By Server Relative Url
Share Point Get File By Server Relative UrlIntegration name: SHARE_POINT_GET_FILE_BY_SERVER_RELATIVE_URL
DEPRECATED: Use GetSiteDriveItemByPath instead. Tool to fetch SharePoint file metadata (exists/permissions/URLs/UniqueId) given a server-relative path, using the more robust ServerRelativePath API for special characters. Use after SHARE_POINT_SEARCH_QUERY returns a Path and you need to confirm the canonical working path or retrieve file properties without downloading bytes.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
expand
string
"ListItemAllFields"
OData $expand query option. Comma-separated list of related entities to expand, such as 'ListItemAllFields' to include list item metadata.
select
string
"ServerRelativeUrl,UniqueId,Name,Length,TimeLastModified"
OData $select query option. Comma-separated list of fields to return. E.g., 'ServerRelativeUrl,UniqueId,Name,Length,TimeLastModified,LinkingUri'.
site_name
string
"Workshopsubmissions"
Optional SharePoint site name to scope the file retrieval. Required when accessing files in a subsite (e.g., when the path starts with /sites/). If the file path is '/sites/Workshopsubmissions/Shared Documents/file.pdf', set site_name='Workshopsubmissions'. If not provided, the file is resolved from the tenant root site context. This parameter is auto-extracted from paths starting with /sites/ if not explicitly provided.
server_relative_path_decoded
string
✅
"/sites/Finance/Shared Documents/W-9.pdf"
Decoded server-relative path of the file, starting with '/'. E.g., '/sites/Finance/Shared Documents/W-9.pdf' or '/Shared Documents/report.pdf'. Do not URL-encode; provide the path with spaces and special characters as-is.
Share Point Get Folder By Server Relative Url
Share Point Get Folder By Server Relative UrlIntegration name: SHARE_POINT_GET_FOLDER_BY_SERVER_RELATIVE_URL
DEPRECATED: Use SHARE_POINT_GET_SITE_DRIVE_ITEM_BY_PATH instead. Tool to retrieve a folder by its server-relative URL. Use when you need to fetch folder metadata by path before further operations. Returns only the immediate folder; to traverse nested structures, iterate Folders.results and call this tool recursively for each subfolder.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
expand
string
"Files,Folders"
OData $expand query option. Comma-separated list of related entities to expand, such as 'Files,Folders,ListItemAllFields'. Expanding Files or Folders can produce large responses; access nested data via Files.results and Folders.results arrays.
select
string
"Name,ServerRelativeUrl,ItemCount"
OData $select query option. Comma-separated list of fields to return. E.g., 'Name,ServerRelativeUrl,ItemCount'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site_name}.
server_relative_url
string
✅
"/Shared Documents/MyFolder"
Server-relative URL of the folder to retrieve, including library and any parent folders. Can be provided as a plain path (e.g., '/Shared Documents/MyFolder') or as a pre-encoded URL (e.g., '/Shared%20Documents/MyFolder'). Both formats are accepted and handled correctly. Path must exactly match the real SharePoint library name (e.g., '/Shared Documents' not '/Documents'); extra or missing slashes cause resolution failures. Prefer reusing the server_relative_url returned by this tool for downstream calls rather than constructing paths manually.
Share Point Get Group Users
Share Point Get Group UsersIntegration name: SHARE_POINT_GET_GROUP_USERS
Retrieves all users who are members of a specified SharePoint group. This action returns user information including IDs, names, email addresses, login names, and permission details. Supports OData query parameters for filtering, sorting, field selection, and pagination. Use this when you need to audit group membership, check user permissions, or list members of a specific group.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
10
OData $top parameter to limit the number of returned users. Must be a positive integer.
expand
string
"Groups"
OData $expand parameter to expand related navigation properties. Use 'Groups' to get the user's group memberships.
filter
string
"PrincipalType eq 1"
OData $filter parameter to filter the returned users. Use OData filter syntax (e.g., 'PrincipalType eq 1' for regular users).
select
string
"Id,Title,Email"
OData $select parameter to return only specific user fields. Comma-separated field names (e.g., 'Id,Title,Email,LoginName').
orderby
string
"Title"
OData $orderby parameter to sort the returned users. Specify field name and optional 'asc' or 'desc' (e.g., 'Title desc').
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
skiptoken
string
—
OData $skiptoken parameter for pagination. Use the skiptoken value from a previous response's __next link to get the next page of results.
group_name
string
✅
"Communication site Members"
Name of the SharePoint group to retrieve users from. Use the LoginName or Title of the group (e.g., 'Communication site Members', 'Site Owners').
Share Point Get Group Users By Id
Share Point Get Group Users By IdIntegration name: SHARE_POINT_GET_GROUP_USERS_BY_ID
Tool to retrieve all users in a specific SharePoint site group by group ID. Use when you have the numeric group ID and need to list all members of that group, including their IDs, names, email addresses, and permission details. Supports OData query parameters for filtering, sorting, field selection, and pagination.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
10
OData $top parameter to limit the number of returned users. Must be a positive integer.
expand
string
"Groups"
OData $expand parameter to expand related navigation properties. Use 'Groups' to get the user's group memberships.
filter
string
"PrincipalType eq 1"
OData $filter parameter to filter the returned users. Use OData filter syntax (e.g., 'PrincipalType eq 1' for regular users).
select
string
"Id,Title,Email"
OData $select parameter to return only specific user fields. Comma-separated field names (e.g., 'Id,Title,Email,LoginName').
orderby
string
"Title"
OData $orderby parameter to sort the returned users. Specify field name and optional 'asc' or 'desc' (e.g., 'Title desc').
group_id
integer
✅
3
Numeric ID of the SharePoint site group to retrieve users from. Use list_site_groups action to get available group IDs.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
skiptoken
string
—
OData $skiptoken parameter for pagination. Use the skiptoken value from a previous response's __next link to get the next page of results.
Share Point Get Item Attachment Content
Share Point Get Item Attachment ContentIntegration name: SHARE_POINT_GET_ITEM_ATTACHMENT_CONTENT
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
item_id
integer
✅
1
ID of the list item to retrieve the attachment from (must be non-negative).
file_name
string
✅
"report.pdf"
Exact name of the attachment file, including extension.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
"Documents"
Title of the SharePoint list containing the target item.
Share Point Get List By Guid
Share Point Get List By GuidIntegration name: SHARE_POINT_GET_LIST_BY_GUID
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
expand
string
—
Comma-separated list of related entities to include in the response. Common values: Fields (list fields/columns), RootFolder (folder information), ContentTypes, Views. Example: 'Fields' or 'RootFolder'
select
string
—
Comma-separated list of fields to return. Limits the response to only specified fields. Common fields: Title, Id, Description, ItemCount, BaseType, BaseTemplate, Created, Hidden, EntityTypeName, ListItemEntityTypeFullName. Example: 'Title,Id,ItemCount'
list_guid
string
✅
"01234567-89ab-cdef-0123-456789abcdef"
GUID of the SharePoint list to retrieve, in canonical format, e.g., '01234567-89ab-cdef-0123-456789abcdef'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Get List By Title
Share Point Get List By TitleIntegration name: SHARE_POINT_GET_LIST_BY_TITLE
Tool to retrieve a SharePoint list by its title. Use when you need to fetch list metadata by title.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
expand
string
—
Comma-separated list of related entities to include in the response. Common values: Fields (list fields/columns), RootFolder (folder information), ContentTypes, Views. Example: 'Fields' or 'RootFolder' Expanding Fields includes system and hidden fields; check the Hidden metadata flag to identify user-facing columns.
select
string
—
Comma-separated list of fields to return. Limits the response to only specified fields. Common fields: Title, Id, Description, ItemCount, BaseType, BaseTemplate, Created, Hidden, EntityTypeName, ListItemEntityTypeFullName. Example: 'Title,Id,ItemCount' Include 'Id' when the list GUID is needed as list_guid/list_id for downstream calls like SHARE_POINT_CREATE_LIST_FIELD.
site_name
string
"testcomposio"
Optional SharePoint site name to scope the list retrieval. If provided, the list is fetched from /sites/{site}. If not provided, the list is fetched from the tenant root site. E.g., 'testcomposio' for a site at /sites/testcomposio.
list_title
string
✅
"Documents"
Title of the SharePoint list to retrieve. Will be URL-encoded and enclosed in single quotes in the endpoint. Must be an exact case-sensitive match to the list's display title; typos or renamed lists will cause lookup failures.
Share Point Get List Content Type By Id
Share Point Get List Content Type By IdIntegration name: SHARE_POINT_GET_LIST_CONTENT_TYPE_BY_ID
Tool to retrieve a specific content type from a SharePoint list by its ID. Use when you need detailed information about a particular content type including its fields, schema, and metadata.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
list_id
string
✅
"0e0f0c3b-e23e-4aaf-8e22-803a3b572315"
GUID of the SharePoint list containing the content type, in canonical format (e.g., '0e0f0c3b-e23e-4aaf-8e22-803a3b572315').
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
content_type_id
string
✅
"0x010100EAADC19ECD09234BAD136AAD68B38066"
The content type identifier, a hexadecimal string (e.g., '0x010100EAADC19ECD09234BAD136AAD68B38066'). This is the unique ID of the content type within SharePoint.
Share Point Get List Item By Id
Share Point Get List Item By IdIntegration name: SHARE_POINT_GET_LIST_ITEM_BY_ID
Tool to retrieve a SharePoint list item by ID. Use when you need to fetch a specific item after knowing its ID.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
expand
string
—
OData $expand to expand related entities, e.g., 'Author,Editor'. Must be used together with select parameter that includes the expanded fields.
select
string
—
OData $select to specify which fields to return, e.g., 'Title,Created'. Required when using expand parameter.
item_id
integer
✅
1
Numeric ID of the list item to retrieve.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
"My List"
Display title of the target SharePoint list.
Share Point Get List Items
Share Point Get List ItemsIntegration name: SHARE_POINT_GET_LIST_ITEMS
Tool to retrieve items from a SharePoint list. Use when you need to fetch list entries with optional OData parameters.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
10
Maximum number of items to return.
expand
string
"Author,Editor"
Comma-separated list of navigation properties to expand for lookup fields.
filter
string
"Title eq 'Test'"
OData filter expression to limit results (e.g., Title eq 'Test').
select
string
"Title,Id"
Comma-separated list of internal field names to return. Use '' to retrieve all available fields, which is recommended when you don't know the exact field names. SharePoint uses internal field names, not display names - spaces are hex-encoded as 'x0020' (e.g., 'File_x0020_Size' for 'File Size'). Common system fields: Id, Title, Created, Modified, AuthorId, EditorId, GUID, FileLeafRef (file name), FileDirRef (folder path), FileRef (server-relative URL). Field availability varies by list type: document libraries include file-specific fields like File_x0020_Size, while custom lists have their own schema. To discover available fields for a specific list, either: (1) use select='' first to see all fields returned in items, or (2) use SHARE_POINT_GET_LIST_BY_TITLE with expand='Fields' to get field metadata including InternalName.
orderby
string
"Created desc"
OData orderby expression to sort results (e.g., Created desc).
site_name
string
"testcomposio"
Optional SharePoint site name to scope the list retrieval. If provided, the list is fetched from /sites/{site}. If not provided, the list is fetched from the tenant root site. E.g., 'testcomposio' for a site at /sites/testcomposio.
skiptoken
string
"Paged=TRUE&p_ID=15"
Token for paging through results.
list_title
string
✅
"Documents"
Exact Title property value of the SharePoint list to query. The Title property value varies by site configuration and localization - for example, the default document library's Title may be 'Documents', 'Shared Documents', or a localized name. To find the exact Title property value, use SHARE_POINT_LIST_ALL_LISTS which returns all lists with their Title properties.
Share Point Get List Items By Guid
Share Point Get List Items By GuidIntegration name: SHARE_POINT_GET_LIST_ITEMS_BY_GUID
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
10
Maximum number of items to return.
expand
string
"Author,Editor"
Comma-separated list of navigation properties to expand for lookup fields.
filter
string
"Title eq 'Test'"
OData filter expression to limit results (e.g., Title eq 'Test').
select
string
"Title,Id"
Comma-separated list of internal field names to return. Use '' to retrieve all available fields, which is recommended when you don't know the exact field names. SharePoint uses internal field names, not display names - spaces are hex-encoded as 'x0020' (e.g., 'File_x0020_Size' for 'File Size'). Common system fields: Id, Title, Created, Modified, AuthorId, EditorId, GUID, FileLeafRef (file name), FileDirRef (folder path), FileRef (server-relative URL). Field availability varies by list type: document libraries include file-specific fields like File_x0020_Size, while custom lists have their own schema. To discover available fields for a specific list, either: (1) use select='' first to see all fields returned in items, or (2) use SHARE_POINT_GET_LIST_BY_GUID with expand='Fields' to get field metadata including InternalName.
orderby
string
"Created desc"
OData orderby expression to sort results (e.g., Created desc).
list_guid
string
✅
"a12e3d6e-9414-462d-bd53-cf06f3982ad3"
GUID of the SharePoint list to retrieve items from, in canonical format. The GUID uniquely identifies a list across the SharePoint site. To find list GUIDs, use SHARE_POINT_LIST_ALL_LISTS which returns all lists with their Id (GUID) properties.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
skiptoken
string
"Paged=TRUE&p_ID=15"
Token for paging through results.
Share Point Get List Item Version
Share Point Get List Item VersionIntegration name: SHARE_POINT_GET_LIST_ITEM_VERSION
Tool to retrieve a specific version of a SharePoint list item. Use when you need to access historical versions of list items.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
item_id
integer
✅
1
Numeric ID of the list item whose version to retrieve.
list_guid
string
✅
"a12e3d6e-9414-462d-bd53-cf06f3982ad3"
GUID of the SharePoint list in canonical format, e.g., '01234567-89ab-cdef-0123-456789abcdef'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
version_id
integer
✅
512
Version ID of the specific list item version to retrieve.
Share Point Get My Followed
Share Point Get My FollowedIntegration name: SHARE_POINT_GET_MY_FOLLOWED
Tool to get entities the current user is following. Use when you need to retrieve followed users, documents, sites, or tags after authentication.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
types
integer
✅
1
Bitmask of actor types to include. Users=1, Documents=2, Sites=4, Tags=8. Combine values with bitwise OR (e.g., 15 for all).
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Get My Followers
Share Point Get My FollowersIntegration name: SHARE_POINT_GET_MY_FOLLOWERS
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
—
The subsite name to scope the request to (e.g., composio-test). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Get Role Definitions
Share Point Get Role DefinitionsIntegration name: SHARE_POINT_GET_ROLE_DEFINITIONS
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
5
OData top: Maximum number of items to return, must be ≥ 1.
expand
string
"BasePermissions"
OData expand: Expand related entities (bulk expansion not supported).
filter
string
"Name eq 'Read'"
OData filter: Expression to filter returned role definitions (e.g., "Name eq 'Read'"). Name-based filters may be case-sensitive or locale-sensitive; normalize role names before constructing filter expressions to avoid empty results.
select
string
"Name,Id"
OData select: Comma-separated list of properties to return (e.g., 'Name,Id').
orderby
string
"Name desc"
OData orderby: Sort order (e.g., 'Name desc').
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
skiptoken
string
"Paged=TRUE&p_ID=20"
OData skiptoken: Pagination token for continuing a prior query.
Share Point Get Site Collection Info
Share Point Get Site Collection InfoIntegration name: SHARE_POINT_GET_SITE_COLLECTION_INFO
Tool to fetch site collection metadata (URL, ID, root web URI) only—not list item or document-level details. Use before subsequent calls to resolve correct API names. Requires SharePoint connection with site-collection-level scopes; may fail even when user-level tools succeed. Verify site_id before use—an incorrect site_id can silently return data for an unrelated site.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
expand
string
"Owner"
OData $expand to expand navigation properties, e.g., 'Owner,RootWeb'.
select
string
"Id,Url"
OData $select to specify fields to return, e.g., 'Id,Url,ServerRelativeUrl'.
Share Point Get Site Drive Item By Path
Share Point Get Site Drive Item By PathIntegration name: SHARE_POINT_GET_SITE_DRIVE_ITEM_BY_PATH
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
expand
string
"ListItemAllFields"
OData $expand query option. Comma-separated list of related entities to expand. E.g., 'ListItemAllFields' for files, or 'Files,Folders' for folders.
select
string
"Name,ServerRelativeUrl,UniqueId,Length"
OData $select query option. Comma-separated list of fields to return. E.g., 'Name,ServerRelativeUrl,UniqueId,Length,TimeLastModified'.
item_path
string
✅
"/Shared Documents/report.pdf"
Server-relative path of the file or folder to retrieve, starting with '/'. E.g., '/Shared Documents/file.pdf' for files or '/Shared Documents/MyFolder' for folders. Can be provided as a plain path or pre-encoded. Both formats are accepted.
site_name
string
"Workshopsubmissions"
Optional SharePoint site name to scope the retrieval. Required when accessing items in a subsite (e.g., when the path starts with /sites/). If the path is '/sites/Workshopsubmissions/Shared Documents/file.pdf', set site_name='Workshopsubmissions'. If not provided, the item is resolved from the tenant root site context.
Share Point Get Site Page Content
Share Point Get Site Page ContentIntegration name: SHARE_POINT_GET_SITE_PAGE_CONTENT
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
item_id
integer
5
List item ID of the page in the Site Pages library. Either page_file_name or item_id must be provided.
render_as
string
"raw"
Format for retrieving content fields. 'raw' returns direct field values (CanvasContent1, LayoutWebpartsContent). 'text' uses FieldValuesAsText endpoint for plain text rendering. 'html' uses FieldValuesAsHtml endpoint for HTML rendering.
site_name
string
"testcomposio"
Optional SharePoint site name to scope the page retrieval. If provided, the page is retrieved from /sites/{site}. If not provided, the page is retrieved from the tenant root site. E.g., 'testcomposio' for a site at /sites/testcomposio.
page_file_name
string
"Home.aspx"
File name of the modern SharePoint page to retrieve (e.g., 'Formed-LLC-&-Received-EIN.aspx'). Must include the .aspx extension. Either page_file_name or item_id must be provided.
Share Point Get User Effective Permissions On Web
Share Point Get User Effective Permissions On WebIntegration name: SHARE_POINT_GET_USER_EFFECTIVE_PERMISSIONS_ON_WEB
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
login_name
string
✅
`"i:0#.f
membership
Share Point Get Webhook Subscription
Share Point Get Webhook SubscriptionIntegration name: SHARE_POINT_GET_WEBHOOK_SUBSCRIPTION
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
list_id
string
✅
"a12e3d6e-9414-462d-bd53-cf06f3982ad3"
GUID of the SharePoint list containing the subscription, in canonical format, e.g., '01234567-89ab-cdef-0123-456789abcdef'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
subscription_id
string
✅
"a8e6d5e6-9f7f-497a-b97f-8ffe8f559dc7"
GUID of the webhook subscription to retrieve, in canonical format, e.g., '01234567-89ab-cdef-0123-456789abcdef'.
Share Point Get Webhook Subscriptions
Share Point Get Webhook SubscriptionsIntegration name: SHARE_POINT_GET_WEBHOOK_SUBSCRIPTIONS
Tool to retrieve all webhook subscriptions on a SharePoint list. Use when you need to view existing webhook configurations for a list.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
list_id
string
✅
"a12e3d6e-9414-462d-bd53-cf06f3982ad3"
The GUID of the SharePoint list to retrieve subscriptions for, in canonical format (e.g., '01234567-89ab-cdef-0123-456789abcdef').
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Get Web Info
Share Point Get Web InfoIntegration name: SHARE_POINT_GET_WEB_INFO
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
expand
string
"CurrentUser"
OData $expand to expand navigation properties, e.g., 'CurrentUser,Lists,Webs'.
select
string
"Id,Title,Url"
OData $select to specify fields to return, e.g., 'Id,Title,Url,ServerRelativeUrl'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Is Followed
Share Point Is FollowedIntegration name: SHARE_POINT_IS_FOLLOWED
Tool to check if the current user is following a specified actor. Use when verifying follow status before performing follow or unfollow operations.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
tag_guid
string
—
GUID of the tag when actor_type=3.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
actor_type
integer
✅
0
Type of the actor to check: 0=user, 1=document, 2=site, 3=tag.
content_uri
string
—
URI of the document or site when actor_type=1 or 2, e.g., 'http://server/site'.
account_name
string
—
Account name for a user when actor_type=0, in claims format, e.g., 'i:0#.f|membership|user@domain.com'.
Share Point List All Lists
Share Point List All ListsIntegration name: SHARE_POINT_LIST_ALL_LISTS
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
10
OData $top to limit the number of results.
expand
string
"Fields"
OData $expand to include related entities.
filter
string
"Hidden eq false"
OData $filter to narrow results.
select
string
"Title,Id"
OData $select to specify which list fields to return, e.g., 'Title,Id'.
orderby
string
"Title desc"
OData $orderby to sort results, e.g., 'Title desc'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
skiptoken
string
"Paged=TRUE&p_ID=15"
OData $skiptoken for paging through results. The token value is returned in the previous response when more results exist; pass it unchanged to retrieve the next page.
Share Point List Drive Children
Share Point List Drive ChildrenIntegration name: SHARE_POINT_LIST_DRIVE_CHILDREN
Tool to list children (files and folders) in a SharePoint drive using REST API v2.0. Use when you need to enumerate items in a drive's root folder or a specific folder within the drive.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
200
Number of items to return (OData $top parameter). Default is 200.
filter
string
"folder ne null"
OData filter expression. Common values: 'folder ne null' (only folders), 'file ne null' (only files), or custom filters like "name eq 'document.pdf'".
select
string
"id,name,size,folder,file,webUrl"
Comma-separated properties to return (e.g., 'id,name,size,folder,file,webUrl').
orderby
string
"name asc"
OData orderby expression (e.g., 'name asc', 'lastModifiedDateTime desc').
drive_id
string
✅
"b!-RIj2DuyvEyV1T4NlOaMHk8XkS_I8MdFlUCq1BlcjgmhRfAj3-Z8RY2VpuvV_tpd"
The unique identifier of the drive. This is the drive ID (GUID) that identifies a specific document library or OneDrive.
folder_id
string
"01BYE5RZ6QN3ZWBTUFOFD3GSPGOHDJD36K"
The unique identifier of a specific folder within the drive. If not provided, lists root folder children.
Share Point List Drive Recent Items
Share Point List Drive Recent ItemsIntegration name: SHARE_POINT_LIST_DRIVE_RECENT_ITEMS
Tool to list recently modified items in a SharePoint drive using Microsoft Graph API. Returns files and folders from the root folder sorted by modification time (most recent first). Note: This action uses the /root/children endpoint with $orderby=lastModifiedDateTime desc to retrieve recently modified items from the root folder.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
drive_id
string
✅
"b!your_drive_id_here"
The unique identifier of the drive. This is the drive ID (GUID) that identifies a specific document library or OneDrive.
row_limit
integer
20
Maximum number of recently modified items to return. Default is 20.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used.
Share Point List Drives Rest Api
Share Point List Drives Rest ApiIntegration name: SHARE_POINT_LIST_DRIVES_REST_API
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).
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
100
OData $top parameter - number of drives to return. Default: 100.
expand
string
"root"
OData $expand parameter to expand related entities (e.g., 'root,items').
select
string
"id,name,webUrl,driveType"
OData $select parameter - comma-separated properties to return (e.g., 'id,name,webUrl,driveType').
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
site_path
string
"root"
Site identifier or path segment (e.g., 'teamsite', 'engineering', or a site ID). Use 'root' for the root site. Do not include 'sites/' prefix as it is added automatically.
sharepoint_site_url
string
"https://composio2024.sharepoint.com"
Full SharePoint site URL (e.g., 'https://composio2024.sharepoint.com'). If not provided, uses the default site from connection.
Share Point List Files In Folder
Share Point List Files In FolderIntegration name: SHARE_POINT_LIST_FILES_IN_FOLDER
Tool to list files within a SharePoint folder (non-recursive; does not enumerate subfolders). Use when you need to enumerate all files in a folder by its server-relative URL. To cover nested structures, call the tool separately for each subfolder.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
100
OData $top to limit the number of files returned.
expand
string
"ListItemAllFields"
OData $expand to inline related entities (e.g., 'ListItemAllFields'). When expanding 'Files,Folders', access results via Files.results and Folders.results arrays in the response.
select
string
"Name,ServerRelativeUrl,Length"
OData $select to specify which file properties to return (comma-separated).
orderby
string
"Name desc"
OData $orderby to sort the results (e.g., 'Name desc').
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
skiptoken
string
"Paged=TRUE&p_ID=15"
OData $skiptoken for server-side paging.
folder_name
string
✅
"/Shared Documents"
Server-relative URL of the folder, e.g., '/Shared Documents' or '/sites/MySite/Folder'. Must be a valid path to an existing folder. Near-miss paths (wrong casing, extra/missing slashes, abbreviated names) silently return empty results rather than an error; use server_relative_url values from prior API responses to ensure exact paths.
Share Point List Item Attachments
Share Point List Item AttachmentsIntegration name: SHARE_POINT_LIST_ITEM_ATTACHMENTS
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
item_id
integer
✅
1
ID of the list item to list attachments for (must be ≥ 1).
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
"My List"
Display title of the SharePoint list containing the item.
Share Point List List Columns
Share Point List List ColumnsIntegration name: SHARE_POINT_LIST_LIST_COLUMNS
Tool to list all column definitions in a SharePoint list. Use when you need to retrieve field metadata including column names, types, and properties.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
10
OData $top to limit the number of results.
filter
string
"Hidden eq false"
OData $filter to narrow results, e.g., 'Hidden eq false'.
select
string
"Title,InternalName,TypeAsString"
OData $select to specify which column fields to return, e.g., 'Title,InternalName,TypeAsString'.
list_id
string
✅
"01234567-89ab-cdef-0123-456789abcdef"
GUID of the SharePoint list to retrieve columns for, in canonical format, e.g., '01234567-89ab-cdef-0123-456789abcdef'.
orderby
string
"Title asc"
OData $orderby to sort results, e.g., 'Title asc'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point List Recycle Bin Items
Share Point List Recycle Bin ItemsIntegration name: SHARE_POINT_LIST_RECYCLE_BIN_ITEMS
Tool to list items in the SharePoint Recycle Bin. Use when you need to retrieve deleted items and page through results.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
10
Maximum number of items to return.
expand
string
"Author,DeletedBy"
Comma-separated list of navigation properties to expand (e.g., Author,DeletedBy).
filter
string
"ItemState eq 1"
OData filter expression to filter items (e.g., ItemState eq 1).
select
string
"Id,Title,DeletedDate"
Comma-separated list of fields to include in the response (e.g., Id,Title,DeletedDate).
orderby
string
"DeletedDate desc"
OData orderby expression to sort results (e.g., DeletedDate desc).
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., composio-test). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
skiptoken
string
"Paged=TRUE&p_ID=15"
Token for server-driven pagination. Extract this value from the @odata.nextLink or pagination token in the previous response and pass it into the next call to retrieve subsequent pages.
Share Point List Site Groups
Share Point List Site GroupsIntegration name: SHARE_POINT_LIST_SITE_GROUPS
Tool to list SharePoint site groups for a site collection. Use when you need to see all groups and their settings before managing permissions.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
10
OData $top clause to limit the number of returned groups.
skip
integer
5
OData $skip clause for paging, number of results to skip.
expand
string
"Users,Owner"
OData $expand clause to pull in navigation properties like Users or Owner.
filter
string
"substringof('Owners',Title)"
OData $filter clause to filter results. Example: "substringof('Owners',Title)"
select
string
"Title,Id"
OData $select clause to specify which group fields to return. Example: 'Title,Id'
orderby
string
"Title desc"
OData $orderby clause to sort results. Example: 'Title desc'
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point List Sites
Share Point List SitesIntegration name: SHARE_POINT_LIST_SITES
Tool to retrieve all SharePoint sites accessible to the user. Use when you need to discover available sites before performing site-specific operations.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
50
Number of sites to return. Maximum value is 500.
search
string
"*"
Search query to filter sites by name or description. Use '*' to get all sites.
select
string
"SiteId,SiteName,Title,Path"
Comma-separated list of managed property names to return. Common properties: SiteId, SiteName, Title, Path, Description, Created, LastModifiedTime. If not specified, SharePoint returns a default set of properties.
Share Point List Site Users
Share Point List Site UsersIntegration name: SHARE_POINT_LIST_SITE_USERS
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
10
OData top to limit the number of results.
expand
string
"Groups"
OData expand to include related entities, e.g., 'Groups'.
filter
string
"PrincipalType eq 1"
OData filter to narrow results, e.g., 'PrincipalType eq 1'. substringof filters are case-sensitive; normalize casing in filter values to avoid missing valid matches.
select
string
"Title,Email"
OData select to specify which user fields to return, e.g., 'Title,Email'. Email can be empty for some users; prefer LoginName or Id for reliable identification.
orderby
string
"Title asc"
OData orderby to sort results, e.g., 'Title asc'.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
skiptoken
string
"Paged=TRUE&p_ID=15"
OData skiptoken for paging through results. Iterate requests following each returned skiptoken until no further skiptoken is returned to retrieve all users.
Share Point List Subfolders In Folder
Share Point List Subfolders In FolderIntegration name: SHARE_POINT_LIST_SUBFOLDERS_IN_FOLDER
Tool to list immediate child folders within a SharePoint folder. Use when you need folder navigation or directory discovery by server-relative URL.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
top
integer
100
OData $top to limit the number of subfolders returned.
select
string
"Name,ServerRelativeUrl,UniqueId"
OData $select to specify which folder properties to return (comma-separated).
orderby
string
"Name asc"
OData $orderby to sort the results (e.g., 'Name desc').
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
folder_server_relative_url
string
✅
"/Shared Documents"
Server-relative URL of the parent folder, e.g., '/Shared Documents' or '/sites/MySite/Folder'. Must be a valid path to an existing folder. For folders with special characters (#, %), the action will automatically use the ResourcePath-based endpoint.
Share Point Log Event
Share Point Log EventIntegration name: SHARE_POINT_LOG_EVENT
Log custom usage analytics events in SharePoint for tracking user activities. Records usage events (views, edits, custom actions) to SharePoint's analytics system. Use this after performing actions to track usage patterns. The event will be logged to SharePoint's usage analytics database for reporting and analytics purposes. Common use cases:
Track document views or edits
Record custom user interactions
Log application-specific events for analytics
Note: Obtain site/web GUIDs from GET /api/site or GET /api/web endpoints. Use consistent item_id, scope_id, and site GUIDs across related events for the same entity to ensure correct analytics grouping and correlation in reports.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
user
string
✅
"user@domain.com"
User identifier who triggered the event. Can be email address (user@domain.com), display name, or SharePoint LoginName (i:0#.f|membership|user@domain.com).
item_id
string
✅
"5e304156-934d-4f4c-9d1e-05738a5f8a72"
GUID of the item (document, list item, or web) related to this event. Can be a document ID, list item ID, web ID, or site collection ID.
site_id
string
✅
"8f1106b0-6c8a-4a8f-aaa6-307738e1dd82"
GUID of the site collection where the event occurred. Use the site collection ID from GET /api/site.
scope_id
string
✅
"8f1106b0-6c8a-4a8f-aaa6-307738e1dd82"
GUID defining the scope/context of the event. Typically the web ID or site collection ID where the event occurred.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
event_type_id
integer
✅
1
ID of the usage event type. Valid values are typically 1-4 for different SharePoint event types (e.g., 1=View, 2=Edit, 3=Custom). Use values 1-4 for standard tracking events.
Share Point Recycle File
Share Point Recycle FileIntegration name: SHARE_POINT_RECYCLE_FILE
Tool to move a file to the Recycle Bin. Use when you need to recycle a file after confirming its folder and filename paths.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
file_relative_url
string
✅
"document.docx"
Relative URL of the file within the folder to recycle, e.g., 'document.docx'. Do not include a leading '/'.
folder_relative_url
string
✅
"/Shared Documents/Folder1"
Server-relative URL of the folder containing the file to recycle, e.g., '/Shared Documents/Folder1'.
Share Point Recycle List Item
Share Point Recycle List ItemIntegration name: SHARE_POINT_RECYCLE_LIST_ITEM
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
item_id
integer
✅
1
Numeric ID of the list item to recycle.
list_id
string
✅
"01234567-89ab-cdef-0123-456789abcdef"
GUID of the SharePoint list containing the target item, in canonical format (e.g., '01234567-89ab-cdef-0123-456789abcdef').
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Rename Folder
Share Point Rename FolderIntegration name: SHARE_POINT_RENAME_FOLDER
Renames a SharePoint folder by updating its list item metadata. To use this action:
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
new_name
string
✅
"NewFolder"
New folder name (leaf name only, not full path). This will be used for both the display name (Title) and the actual folder name (FileLeafRef). Do not include path separators (/).
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
match_etag
string
—
ETag value for concurrency control. Use '*' (default) to overwrite regardless of the current version. To enforce version checking, obtain the ETag from GET_FOLDER_BY_SERVER_RELATIVE_URL with expand=ListItemAllFields, then use the '__metadata.etag' value.
__metadata.type
string
✅
"SP.Data.Shared_x0020_DocumentsItem"
OData entity type of the folder's list item. This is required by SharePoint's REST API. To obtain this value, first call GET_FOLDER_BY_SERVER_RELATIVE_URL with expand=ListItemAllFields, then extract the '__metadata.type' field from ListItemAllFields (typically 'SP.Data.Shared_x0020_DocumentsItem' for the 'Shared Documents' library, but varies by library name).
server_relative_folder_url
string
✅
"/Shared Documents/OldFolder"
Server-relative path of the folder to rename, including library and any parent folders. Must start with '/' and include the document library name. Example: '/Shared Documents/OldFolder' or '/Shared Documents/ParentFolder/OldFolder'.
Share Point Render List Data As Stream
Share Point Render List Data As StreamIntegration name: SHARE_POINT_RENDER_LIST_DATA_AS_STREAM
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
"testcomposio"
Optional SharePoint site name to scope the list data request. If provided, the list path is resolved relative to this site. If not provided and list_server_relative_url starts with '/sites/{site}/', the site is extracted automatically from the path. E.g., 'testcomposio' for a site at /sites/testcomposio.
parameters
object
—
Body parameters to control rendering options for RenderListDataAsStream.
query_params
object
—
Optional query string parameters to control view behavior. See documentation for supported keys.
list_server_relative_url
string
✅
"/Lists/Orders"
Server-relative URL of the list. If 'site' parameter is provided, this should be the path relative to that site (e.g., '/Lists/Orders' or '/Shared Documents'). If 'site' is not provided and the path does not start with '/sites/', it's resolved relative to the tenant root.
Share Point Restore Drive Item Version
Share Point Restore Drive Item VersionIntegration name: SHARE_POINT_RESTORE_DRIVE_ITEM_VERSION
Tool to restore a previous version of a SharePoint drive item. Use when you need to revert a file to an earlier version.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
drive_id
string
✅
"b!sAYRj4psj0qqpjB3OOHdglZBMF5Nk0xPnR4Fc4pfinI6LsO0Ty3NT6hz1n27BFpo"
The unique identifier of the drive containing the item
driveItem_id
string
✅
"01K67O4VSVYSGCL3MHHNDIESCQSPJ6CCZP"
The unique identifier of the drive item (file or folder) to restore
driveItemVersion_id
string
✅
"23.0"
The unique identifier or version number of the version to restore (e.g., '23.0', '1.0')
Share Point Restore Recycle Bin Item
Share Point Restore Recycle Bin ItemIntegration name: SHARE_POINT_RESTORE_RECYCLE_BIN_ITEM
Tool to restore a SharePoint Recycle Bin item. Use when you need to recover a deleted item by providing its GUID.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
recyclebinitemid
string
✅
"123e4567-e89b-12d3-a456-426614174000"
GUID of the Recycle Bin item to restore. Must be a valid GUID string.
Share Point Search Query
Share Point Search QueryIntegration name: SHARE_POINT_SEARCH_QUERY
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
rowlimit
integer
10
Maximum number of results to return per request. Default is determined by SharePoint (typically 50). Maximum is 500.
startrow
integer
0
Zero-based index of the first result to return. Use for pagination (e.g., startrow=0 for page 1, startrow=10 for page 2 with rowlimit=10). Compare TotalRows vs RowCount in the response to determine if additional pages exist; increment startrow by rowlimit until all results are retrieved.
querytext
string
✅
"SharePoint"
The search query using Keyword Query Language (KQL) syntax. Examples: 'project report', 'IsDocument:1', 'FileType:docx', 'Author:"John Doe"'. Broad queries (e.g., '.xlsx' alone) return noisy large result sets; narrow with site paths, Author, date ranges, or other KQL properties. Filter by contentclass to isolate specific item types.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
selectproperties
string
"Title,Author,Path"
Comma-separated list of managed property names to return in results. If not specified, SharePoint returns a default set of properties. Common properties: Title, Author, Path, Size, LastModifiedTime, FileType. Include SiteId and WebId alongside Path to disambiguate items sharing the same title across different locations.
refinementfilters
string
"FileType:equals(\"docx\")"
Refinement filters to narrow search results. Format: 'PropertyName:value' or use FQL syntax for complex filters. Example: 'FileType:equals("docx")'.
Share Point Search Suggest
Share Point Search SuggestIntegration name: SHARE_POINT_SEARCH_SUGGEST
Tool to get search query suggestions. Use when you need to provide autocomplete options for user search input.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
Culture
integer
1033
Locale ID (LCID) for the query.
querytext
string
✅
"sharepoint"
Text for which to retrieve query suggestions.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
EnableStemming
boolean
—
True to enable stemming.
EnableQueryRules
boolean
—
True to enable query rules.
fHitHighlighting
boolean
—
True to bold-match terms in suggestions.
fPreQuerySuggestions
boolean
—
True to get pre-query suggestions; false for post-query.
fPrefixMatchAllTerms
boolean
—
True to return suggestions matching all query prefixes.
fCapitalizeFirstLetters
boolean
—
True to capitalize first letters of each term.
ShowPeopleNameSuggestions
boolean
—
True to include people name suggestions.
iNumberOfQuerySuggestions
integer
—
Number of query suggestions to retrieve. Must be >= 1.
iNumberOfResultSuggestions
integer
—
Number of result suggestions to retrieve. Must be >= 1.
Share Point Sharepoint Check Out File
Share Point Sharepoint Check Out FileIntegration name: SHARE_POINT_SHAREPOINT_CHECK_OUT_FILE
Tool to check out a file in a document library. Use when you need to lock a file before making changes.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
server_relative_path
string
✅
"/Shared Documents/a.txt"
The server-relative path to the file that needs to be checked out, e.g., '/Shared Documents/a.txt'.
Share Point Sharepoint Create Folder
Share Point Sharepoint Create FolderIntegration name: SHARE_POINT_SHAREPOINT_CREATE_FOLDER
Creates a new folder in SharePoint using the REST API. Returns server_relative_url; use it for downstream operations instead of constructing paths manually. Does not configure sharing or permissions on the created folder.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
folder_name
string
✅
—
The name of the folder to create.
relative_path
string
—
Additional path within the document library (optional). The parent path must already exist; non-existent paths cause creation to fail. Path segments must be correctly encoded (e.g., spaces as %20).
document_library
string
—
The document library where the folder should be created.
Share Point Sharepoint Create List
Share Point Sharepoint Create ListIntegration name: SHARE_POINT_SHAREPOINT_CREATE_LIST
Creates a new list in SharePoint using the REST API. Custom columns cannot be added at creation time; use SHARE_POINT_CREATE_LIST_FIELD with the returned list_id to add them afterward. Check success and error fields in the response to confirm creation. Returns a list_id used by downstream tools; note SHARE_POINT_SHAREPOINT_CREATE_LIST_ITEM targets lists by list_name (title).
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
name
string
✅
—
The name of the list to create. Must be unique per site; duplicate names cause failure. Pre-check with SHARE_POINT_GET_LIST_BY_TITLE or SHARE_POINT_LIST_ALL_LISTS before calling.
template
string
✅
—
The template type for the list (e.g., 'genericList', 'documentLibrary', 'tasks', etc.).
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
description
string
—
Description of the list (optional).
Share Point Sharepoint Create List Item
Share Point Sharepoint Create List ItemIntegration name: SHARE_POINT_SHAREPOINT_CREATE_LIST_ITEM
Creates a new item in a SharePoint list. Returns an item_data object containing item_id, Title, and timestamps on success.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
list_name
string
✅
—
The name or title of the list where the item will be created. Must exactly match the list's title as it exists in the site; verify the list exists first using SHARE_POINT_SHAREPOINT_CREATE_LIST if uncertain.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
item_properties
object
✅
—
Dictionary of field names and values for the list item. Example: {'Title': 'New Item', 'Body': 'Content'} Keys must be SharePoint column internal names (not display names); use the SharePoint column settings to find internal names. The example key 'Body' is invalid on default lists — use 'Title' as the minimal valid payload and add fields one at a time to isolate errors.
Share Point Sharepoint Create User
Share Point Sharepoint Create UserIntegration name: SHARE_POINT_SHAREPOINT_CREATE_USER
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
email
string
✅
—
Email address of the Azure AD user to add to SharePoint site. Must be a valid user in your organization's Azure Active Directory.
title
string
—
Optional display name/title for the user in SharePoint. If not provided, the user's existing display name from Azure AD will be used.
tenant
string
—
DEPRECATED: This parameter is no longer used. The tenant is now automatically derived from the connected account's base_url in metadata.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
login_name
string
—
Optional login name for the user. If not provided, defaults to 'i:0#.f|membership|{email}'. This parameter is typically not needed as the email is sufficient.
Share Point Sharepoint Find User
Share Point Sharepoint Find UserIntegration name: SHARE_POINT_SHAREPOINT_FIND_USER
Searches for a user in the SharePoint site by email address and returns their profile information if found. Response includes exists_in_graph, exists_in_sharepoint, and error_details fields; inspect all three together — successful=true can coexist with Graph errors in error_details. When the two backends diverge, treat exists_in_sharepoint as authoritative for access decisions.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
email
string
✅
—
Email address of the user to find. Must be a complete, valid email address — display names and short names are rejected and return 'User not found'. Use SHARE_POINT_LIST_SITE_USERS to resolve a display name to an email first.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
Share Point Sharepoint Remove User
Share Point Sharepoint Remove UserIntegration name: SHARE_POINT_SHAREPOINT_REMOVE_USER
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
email
string
✅
—
Email address of the user to remove.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes 'https://{tenant}.sharepoint.com/sites/{site}'.
Share Point Undo Checkout File
Share Point Undo Checkout FileIntegration name: SHARE_POINT_UNDO_CHECKOUT_FILE
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
server_relative_path
string
✅
"/Shared Documents/test_undocheckout.txt"
Server-relative URL of the file to undo checkout, including library and folders. E.g., '/Shared Documents/test_undocheckout.txt'. This will discard any changes made while checked out.
Share Point Update Content Type
Share Point Update Content TypeIntegration name: SHARE_POINT_UPDATE_CONTENT_TYPE
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
name
string
"Updated Content Type"
The name of the content type. Use this to rename the content type.
group
string
"Custom Content Types"
The group name that this content type belongs to. Use this to change the group classification.
hidden
boolean
—
Indicates whether the content type is hidden in the list's New menu. Set to true to hide the content type.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
description
string
"Updated description via REST API"
The descriptive text for the content type. Use this to update the content type description.
document_set
object
—
Model for document set metadata.
content_type_id
string
✅
"0x01"
The unique identifier of the content type to update. This can be the content type ID (e.g., '0x01' for Item) or the string ID from the Id.StringValue property.
Share Point Update Drive Item
Share Point Update Drive ItemIntegration name: SHARE_POINT_UPDATE_DRIVE_ITEM
Tool to update the properties of a drive item (file or folder) in SharePoint using SharePoint REST API. Use when you need to rename files/folders or update their title property.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
name
string
"new-file-name.docx"
The new name for the item (filename with extension for files, folder name for folders). Use to rename the file or folder.
title
string
"My Document Title"
The new title for the item. This updates the Title field of the list item.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
server_relative_url
string
✅
"/Shared Documents/test.docx"
The server-relative URL of the file or folder to update (e.g., '/Shared Documents/file.docx' or '/sites/mysite/Shared Documents/folder').
Share Point Update List
Share Point Update ListIntegration name: SHARE_POINT_UPDATE_LIST
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
title
string
"Updated List Title"
New title for the list. Provide this to rename the list.
if_match
string
—
ETag value for concurrency control. Use '*' to force update regardless of version. Provide a specific ETag to ensure safe concurrent updates.
list_guid
string
✅
"a12e3d6e-9414-462d-bd53-cf06f3982ad3"
GUID of the SharePoint list to update, in canonical format (e.g., 'a12e3d6e-9414-462d-bd53-cf06f3982ad3').
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
description
string
"Updated list description via API"
New description for the list. Provide this to update the list description.
enable_versioning
boolean
—
Whether versioning is enabled for the list. Set to true to enable, false to disable.
enable_attachments
boolean
—
Whether attachments are enabled for list items. Set to true to enable, false to disable.
content_types_enabled
boolean
—
Whether content types are enabled for the list. Set to true to enable, false to disable.
Share Point Update List Item
Share Point Update List ItemIntegration name: SHARE_POINT_UPDATE_LIST_ITEM
Tool to update fields on an existing SharePoint list item. Use when you need to modify an item's properties with proper ETag concurrency control via MERGE.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
etag
string
—
ETag value for concurrency control. Use '*' to force update regardless of version. Provide a specific ETag (from GET_LIST_ITEM_ETAG tool) to ensure safe concurrent updates. Format: '"guid,version"' like '"c7a93369-bda8-4da1-b1a3-3d87d2e207fc,1"'.
fields
object
✅
{"Title":"Updated Title","Status":"Complete"}
Dictionary mapping internal field names to their new values. Supports text, numbers, booleans, dates, and complex types for lookup/person fields. For lookup and person/group fields, append 'Id' to the field name and provide the ID as an integer (single-value) or {'results': [id1, id2, ...]} for multi-value (OData verbose format). Internal field names with spaces are encoded with 'x0020' (e.g., 'Related_x0020_Item' for 'Related Item').
item_id
integer
✅
1
Numeric ID of the list item to update.
site_name
string
—
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
list_title
string
✅
"Tasks"
The exact title of the SharePoint list containing the item to update.
entity_type_full_name
string
—
The ListItemEntityTypeFullName required for __metadata.type in the request body. If not provided, it will be fetched automatically using GET_LIST_ITEM_ENTITY_TYPE_FULL_NAME. Format: 'SP.Data.{ListName}ListItem' like 'SP.Data.TasksListItem'.
Share Point Update Site
Share Point Update SiteIntegration name: SHARE_POINT_UPDATE_SITE
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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
title
string
"My Updated Site"
The new title for the site. If not provided, the title will not be updated.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., composio-test). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
description
string
"Updated site description"
The new description for the site. If not provided, the description will not be updated.
tree_view_enabled
boolean
—
Whether the tree view is enabled on the site.
quick_launch_enabled
boolean
—
Whether the Quick Launch navigation is enabled on the site.
enable_minimal_download
boolean
—
Whether to enable minimal download strategy for the site.
save_site_as_template_enabled
boolean
—
Whether the 'Save Site as Template' feature is enabled.
Share Point Upload File
Share Point Upload FileIntegration name: SHARE_POINT_UPLOAD_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.
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
file
object
—
File to upload. Alternatively, omit this and provide either 'content_text' for UTF-8 text or 'content_base64' for arbitrary bytes along with 'file_name' to set the filename.
file_name
string
"document.txt"
Filename to use when uploading if 'file' is not provided.
overwrite
boolean
—
Whether to overwrite an existing file with the same name. Defaults to true.
site_name
string
"composio-test"
The subsite name to scope the request to (e.g., 'composio-test'). If omitted, the root site is used. When provided, the API base URL becomes https://{tenant}.sharepoint.com/sites/{site}.
content_text
string
—
Optional raw text content to upload (UTF-8 encoded). Use when not passing 'file'.
content_base64
string
—
Optional base64-encoded bytes to upload. Use for binary content when not passing 'file'.
folder_relative_url
string
✅
"/Shared Documents"
Server-relative URL of the destination folder, starting with '/'. E.g., '/Shared Documents'.
Share Point Upload From Url
Share Point Upload From UrlIntegration name: SHARE_POINT_UPLOAD_FROM_URL
Tool to fetch a file from a URL and upload it to SharePoint. Use when you need to upload files directly from external URLs without downloading them to the client first. When a file with the same name already exists, use conflict_behavior to control the behavior:
'replace': Overwrites the existing file (fails with HTTP 423 if the file is locked/open)
'fail': Returns an error if a file with that name exists
'rename': Uploads with an auto-generated suffix (e.g., 'report 1.docx'), bypassing file locks
Parameters
Your Toolhouse AI worker will automatically pass these parameters as input when the tool is called.
site_id
string
—
SharePoint site ID (e.g., contoso.sharepoint.com,2C712604-...,2D2244C3-...). If not provided, uses the default site from authentication.
drive_id
string
"b!xyz123"
Drive ID where the file should be uploaded. If not provided, uses the default document library.
file_url
string
✅
"https://example.com/document.pdf"
The URL of the file to download and upload to SharePoint. Must be accessible from the server.
file_name
string
"document.pdf"
Name for the uploaded file. If not provided, extracts from the URL or Content-Disposition header.
overwrite
boolean
—
DEPRECATED. Use 'conflict_behavior' instead. true → 'replace', false → 'fail'. Ignored if 'conflict_behavior' is set.
folder_path
string
"Documents"
Folder path relative to the drive root (e.g., 'Documents/Projects'). Defaults to root of drive.
source_headers
object
{"Authorization":"Bearer token123"}
Optional HTTP headers to include when downloading from file_url. Use for authentication tokens, signed URLs, or CDN-specific headers.
conflict_behavior
string
"replace"
Specifies how to handle name conflicts when uploading files to SharePoint.