> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atako.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# SharePoint

> Connect SharePoint to your Atako agents — 13 read and 3 write actions.

Let your agents find your SharePoint sites, read lists and list items, browse and search document libraries, add and update list items and create folders on your behalf.

## Connection

* **Authentication**: OAuth 2.0 — you authorize Atako via SharePoint's consent screen; no key to copy.
* **Scopes requested**:
  * `offline_access`
  * `User.Read`
  * `Sites.Read.All`
  * `Sites.ReadWrite.All`

<Note>
  Nothing to paste: click Connect and sign in with your Microsoft 365 work or school account. Prerequisite on the Atako side — same Microsoft Entra app as Outlook, Teams and OneDrive: an administrator sets INTEGRATION\_OAUTH\_SHAREPOINT\_CLIENT\_ID / \_CLIENT\_SECRET to the same values as INTEGRATION\_OAUTH\_OUTLOOK\_CLIENT\_ID / \_CLIENT\_SECRET, and adds the delegated permissions in Entra → App registrations → Atako → API permissions → Microsoft Graph → Delegated: User.Read, Sites.Read.All, Sites.ReadWrite.All, offline\_access. Sites.ReadWrite.All often requires an administrator of your Microsoft 365 tenant to grant consent (tenants that restrict user consent).

  See [SharePoint's documentation](https://learn.microsoft.com/en-us/graph/api/resources/sharepoint).
</Note>

## Read actions (13)

| Action                | Description                                                                                                                                                                                                                                                  |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `get_item_by_path`    | Fetch a file or folder of a document library by its path from the library root, e.g. "Contracts/2026/Offer Acme.docx". Returns id, name, size, file/folder facet, webUrl.                                                                                    |
| `get_list`            | Fetch a list by id or display title. expand\_columns: true also returns its column definitions (internal names and types) — read it before create\_list\_item / update\_list\_item\_fields.                                                                  |
| `get_list_item`       | Fetch one list item with its column values (fields), created/modified dates and authors.                                                                                                                                                                     |
| `get_site`            | Fetch a site (id, name, displayName, description, webUrl). Pass site\_id "root" for the tenant root site — the quickest check that the connection works.                                                                                                     |
| `get_site_by_path`    | Fetch a site from its URL: hostname "contoso.sharepoint.com" and server-relative path "sites/Marketing" for [https://contoso.sharepoint.com/sites/Marketing](https://contoso.sharepoint.com/sites/Marketing). Returns the site id used by the other actions. |
| `list_drive_children` | List files and folders inside a folder of a document library. item\_id "root" lists the library top level. Optional: top (1–200), orderby ("name" or "lastModifiedDateTime desc").                                                                           |
| `list_drives`         | List the document libraries (drives) of a site — id, name (e.g. "Documents"), webUrl. The drive id is used by the file actions. Optional: top (1–200).                                                                                                       |
| `list_list_items`     | List the items of a list with their column values (fields). Optional: select (column internal names to return), filter (OData, e.g. "fields/Status eq 'Open'" — operators eq, ne, lt, gt, le, ge, startswith; works best on indexed columns), top (1–500).   |
| `list_lists`          | List the lists and document libraries of a site (id, name, displayName, list.template — "genericList", "documentLibrary"…, webUrl).                                                                                                                          |
| `list_pages`          | List the modern pages of a site (id, name, title, webUrl, pageLayout, publishingState, lastModifiedDateTime) — metadata only, not the page content. Optional: top (1–200).                                                                                   |
| `list_subsites`       | List the subsites of a site (id, name, displayName, webUrl).                                                                                                                                                                                                 |
| `search_drive_items`  | Search a document library for files and folders matching a query (file names, metadata and file content). Optional: top (1–200).                                                                                                                             |
| `search_sites`        | Search the SharePoint sites the connected user can access by keyword (site name, title, description). Returns id, name, displayName, webUrl for each site.                                                                                                   |

## Write actions (3)

| Action                    | Description                                                                                                                                                                                                                   |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `create_folder`           | Create a folder in a document library. parent\_id "root" creates it at the library top level. conflictBehavior: "rename" (default, auto-rename), "replace" (overwrite) or "fail" (error if the name exists).                  |
| `create_list_item`        | Add an item to a list. fields maps column INTERNAL names to values, e.g. \{"Title": "Widget", "Color": "Purple", "Weight": 32} — check the columns with get\_list (expand\_columns: true) first. Returns the created item id. |
| `update_list_item_fields` | Update column values of an existing list item: only the columns given in fields change, e.g. \{"Status": "Done", "Quantity": 934}. Returns the updated column values.                                                         |

## Permissions

Every action above must be explicitly granted to an agent before it can be used. See [Permissions](/integrations/permissions) for the grant model and [Security](/integrations/security) for how credentials are protected.