---
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`

## Request

- Base URL: `https://api.your-domain.com`
- URL: `https://api.your-domain.com/integrations/sharepoint/v1/roots`
- Auth: API key in header `X-API-KEY`
- TypeScript: <https://skmtc.dev/neulandai/apis/neuland-ai-hub-api/docs/integrations/sharepoint/v1/roots/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/neulandai/apis/neuland-ai-hub-api.md) - [All operations](https://skmtc.dev/neulandai/apis/neuland-ai-hub-api/llms.txt) - [OpenAPI document](https://skmtc.dev/neulandai/apis/neuland-ai-hub-api/revisions/b53e89b98c2b?raw)