---
title: "List top-level browse entries"
method: GET
path: "/integrations/sharepoint/v1/roots"
tags: ["Sharepoint v1"]
---

# List top-level browse entries

`GET /integrations/sharepoint/v1/roots`

List the source's top-level browse entries (sites or drives) with imported counts.

## Query parameters

- `chat_id` integer, nullable — Scope imported counts to this chat.
- `library_id` integer, nullable — Scope imported counts to this library.
- `assistant_id` integer, nullable — Scope imported counts to this assistant.
- `project_id` integer, nullable — Scope imported counts to this project.
- `cookie_name` string, nullable

## Response `200`

Successful Response

- union
  - DataSourceSiteModel[]
    - `id` string, required — Site id.
    - `web_url` string, required — URL to open the site in the source application.
    - `name` string, nullable, required — Site name.
    - `display_name` string, nullable, required — Human-readable site display name.
    - `description` string, nullable, required — Site description, if set.
    - `imported_count` integer — Number of imported documents from this site in the current scope.
  - DataSourceDriveModel[]
    - `id` string, required — Drive id.
    - `web_url` string, required — URL to open the drive in the source application.
    - `name` string, nullable, required — Drive name.
    - `description` string, nullable, required — Drive description, if set.
    - `root` DataSourceItemModel, required — A file or folder item from a data source, normalized across providers.
      - `id` string, required — Provider item id.
      - `web_url` string, required — URL to open the item in the source application.
      - `drive_id` string, required — Id of the drive containing the item.
      - `site_id` string, nullable, required — Id of the site the item belongs to, if the source is site-rooted.
      - `parent_folder_id` string, required — Id of the parent folder, or 'root'.
      - `parent_path` string, nullable, required — Path of the parent folder within the drive.
      - `name` string, nullable, required — Item name.
      - `description` string, nullable, required — Item description, if set.
      - `size` integer, nullable, required — Item size in bytes.
      - `last_modified_date_time` string, date-time, nullable, required — When the item was last modified.
      - `mimetype` string, nullable, required — MIME type for files; null for folders.
      - `folder` DataSourceFolderModel, required — Metadata specific to folder items.
        - `child_count` integer, required — Number of immediate children inside the folder.
      - `imported` boolean, nullable — Whether this file has already been imported into the current scope.
      - `imported_count` integer, nullable — For folders, the number of imported documents under this folder.
    - `imported_count` integer — Number of imported documents from this drive in the current scope.

## Other responses

- `401` — Missing or invalid authentication, or no valid connector token.
- `403` — User has not consented to the required scope.
- `422` — Validation Error

---

[API](https://skmtc.net/neulandai/apis/neuland-ai-hub-api.md) · [All operations](https://skmtc.net/neulandai/apis/neuland-ai-hub-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/neulandai/neuland-ai-hub-api/revisions/b53e89b98c2b/schema)