AptlyStar

Sharepoint

Work with pages and lists

SharePoint is a collaborative platform from Microsoft that enables users to build and manage internal websites, share documents, and organize team resources. It provides a powerful, flexible solution for creating digital workspaces and streamlining content management across organizations.

With SharePoint, you can:

  • Create team and communication sites: Set up pages and portals to support collaboration, announcements, and content distribution
  • Organize and share content: Store documents, manage files, and enable version control with secure sharing capabilities
  • Customize pages: Add text parts to tailor each site to your team's needs
  • Improve discoverability: Use metadata, search, and navigation tools to help users quickly find what they need
  • Collaborate securely: Control access with robust permission settings and Microsoft 365 integration

In Aptlystar, the SharePoint integration empowers your agents to create and access SharePoint sites and pages as part of their workflows. This enables automated document management, knowledge sharing, and workspace creation without manual effort. Agents can generate new project pages, upload or retrieve files, and organize resources dynamically, based on workflow inputs. By connecting Aptlystar with SharePoint, you bring structured collaboration and content management into your automation flows — giving your agents the ability to coordinate team activities, surface key information, and maintain a single source of truth across your organization.

Usage Instructions

Integrate SharePoint into the workflow. Read/create pages, list sites, and work with lists (read, create, update items). Requires OAuth.

Tools

sharepoint_create_page

Create a new page in a SharePoint site

Input

ParameterTypeRequiredDescription
siteIdstringNoThe ID of the SharePoint site (internal use)
siteSelectorstringNoSelect the SharePoint site
pageNamestringYesThe name of the page to create. Example: My-New-Page.aspx or Report-2024.aspx
pageTitlestringNoThe title of the page (defaults to page name if not provided)
pageContentstringNoThe content of the page

Output

ParameterTypeDescription
pageobjectCreated SharePoint page information
↳ idstringThe unique ID of the created page
↳ namestringThe name of the created page
↳ titlestringThe title of the created page
↳ webUrlstringThe URL to access the page
↳ pageLayoutstringThe layout type of the page
↳ createdDateTimestringWhen the page was created
↳ lastModifiedDateTimestringWhen the page was last modified

sharepoint_read_page

Read a specific page from a SharePoint site

Input

ParameterTypeRequiredDescription
siteSelectorstringNoSelect the SharePoint site
siteIdstringNoThe ID of the SharePoint site (internal use)
pageIdstringNoThe ID of the page to read. Example: a GUID like 12345678-1234-1234-1234-123456789012
pageNamestringNoThe name of the page to read (alternative to pageId). Example: Home.aspx or About-Us.aspx
maxPagesnumberNoMaximum number of pages to return when listing all pages (default: 10, max: 50)

Output

ParameterTypeDescription
pageobjectInformation about the SharePoint page
↳ idstringThe unique ID of the page
↳ namestringThe name of the page
↳ titlestringThe title of the page
↳ webUrlstringThe URL to access the page
↳ pageLayoutstringThe layout type of the page
↳ createdDateTimestringWhen the page was created
↳ lastModifiedDateTimestringWhen the page was last modified
pagesarrayList of SharePoint pages
↳ pageobjectpage output from the tool
↳ idstringThe unique ID of the page
↳ namestringThe name of the page
↳ titlestringThe title of the page
↳ webUrlstringThe URL to access the page
↳ pageLayoutstringThe layout type of the page
↳ createdDateTimestringWhen the page was created
↳ lastModifiedDateTimestringWhen the page was last modified
↳ contentobjectcontent output from the tool
↳ contentstringExtracted text content from the page
↳ canvasLayoutobjectRaw SharePoint canvas layout structure
contentobjectContent of the SharePoint page
↳ contentstringExtracted text content from the page
↳ canvasLayoutobjectRaw SharePoint canvas layout structure
totalPagesnumberTotal number of pages found

sharepoint_list_sites

List details of all SharePoint sites

Input

ParameterTypeRequiredDescription
siteSelectorstringNoSelect the SharePoint site
groupIdstringNoThe group ID for accessing a group team site. Example: a GUID like 12345678-1234-1234-1234-123456789012

Output

ParameterTypeDescription
siteobjectInformation about the current SharePoint site
↳ idstringThe unique ID of the site
↳ namestringThe name of the site
↳ displayNamestringThe display name of the site
↳ webUrlstringThe URL to access the site
↳ descriptionstringThe description of the site
↳ createdDateTimestringWhen the site was created
↳ lastModifiedDateTimestringWhen the site was last modified
↳ isPersonalSitebooleanWhether this is a personal site
↳ rootobjectroot output from the tool
↳ serverRelativeUrlstringServer relative URL
↳ siteCollectionobjectsiteCollection output from the tool
↳ hostnamestringSite collection hostname
sitesarrayList of all accessible SharePoint sites
↳ idstringThe unique ID of the site
↳ namestringThe name of the site
↳ displayNamestringThe display name of the site
↳ webUrlstringThe URL to access the site
↳ descriptionstringThe description of the site
↳ createdDateTimestringWhen the site was created
↳ lastModifiedDateTimestringWhen the site was last modified

sharepoint_create_list

Create a new list in a SharePoint site

Input

ParameterTypeRequiredDescription
siteIdstringNoThe ID of the SharePoint site (internal use)
siteSelectorstringNoSelect the SharePoint site
listDisplayNamestringYesDisplay name of the list to create. Example: Project Tasks or Customer Contacts
listDescriptionstringNoDescription of the list
listTemplatestringNoList template name (e.g., 'genericList')
pageContentstringNoOptional JSON of columns. Either a top-level array of column definitions or an object with { columns: [...] }.

Output

ParameterTypeDescription
listobjectCreated SharePoint list information
↳ idstringThe unique ID of the list
↳ displayNamestringThe display name of the list
↳ namestringThe internal name of the list
↳ webUrlstringThe web URL of the list
↳ createdDateTimestringWhen the list was created
↳ lastModifiedDateTimestringWhen the list was last modified
↳ listobjectList properties (e.g., template)

sharepoint_get_list

Get metadata (and optionally columns/items) for a SharePoint list

Input

ParameterTypeRequiredDescription
siteSelectorstringNoSelect the SharePoint site
siteIdstringNoThe ID of the SharePoint site (internal use)
listIdstringNoThe ID of the list to retrieve. Example: b!abc123def456 or a GUID like 12345678-1234-1234-1234-123456789012

Output

ParameterTypeDescription
listobjectInformation about the SharePoint list
↳ idstringThe unique ID of the list
↳ displayNamestringThe display name of the list
↳ namestringThe internal name of the list
↳ webUrlstringThe web URL of the list
↳ createdDateTimestringWhen the list was created
↳ lastModifiedDateTimestringWhen the list was last modified
↳ listobjectList properties (e.g., template)
↳ columnsarrayList column definitions
listsarrayAll lists in the site when no listId/title provided

sharepoint_update_list

Update the properties (fields) on a SharePoint list item

Input

ParameterTypeRequiredDescription
siteSelectorstringNoSelect the SharePoint site
siteIdstringNoThe ID of the SharePoint site (internal use)
listIdstringNoThe ID of the list containing the item. Example: b!abc123def456 or a GUID like 12345678-1234-1234-1234-123456789012
itemIdstringYesThe ID of the list item to update. Example: 1, 42, or 123
listItemFieldsobjectYesField values to update on the list item

Output

ParameterTypeDescription
itemobjectUpdated SharePoint list item
↳ idstringItem ID
↳ fieldsobjectUpdated field values

sharepoint_add_list_items

Add a new item to a SharePoint list

Input

ParameterTypeRequiredDescription
siteSelectorstringNoSelect the SharePoint site
siteIdstringNoThe ID of the SharePoint site (internal use)
listIdstringYesThe ID of the list to add the item to. Example: b!abc123def456 or a GUID like 12345678-1234-1234-1234-123456789012
listItemFieldsobjectYesField values for the new list item

Output

ParameterTypeDescription
itemobjectCreated SharePoint list item
↳ idstringItem ID
↳ fieldsobjectField values for the new item

sharepoint_upload_file

Upload files to a SharePoint document library

Input

ParameterTypeRequiredDescription
siteIdstringNoThe ID of the SharePoint site
driveIdstringNoThe ID of the document library (drive). If not provided, uses default drive. Example: b!abc123def456
folderPathstringNoOptional folder path within the document library. Example: /Documents/Subfolder or /Shared Documents/Reports
fileNamestringNoOptional: override the uploaded file name. Example: report-2024.pdf
filesfile[]NoFiles to upload to SharePoint

Output

ParameterTypeDescription
uploadedFilesarrayArray of uploaded file objects
↳ idstringThe unique ID of the uploaded file
↳ namestringThe name of the uploaded file
↳ webUrlstringThe URL to access the file
↳ sizenumberThe size of the file in bytes
↳ createdDateTimestringWhen the file was created
↳ lastModifiedDateTimestringWhen the file was last modified
fileCountnumberNumber of files uploaded

On this page