---
title: "List the SharePoint sites this connection can reach"
method: GET
path: "/v1/integrations/accounts/{account_id}/scope/site-options"
tags: ["integrations"]
---

# List the SharePoint sites this connection can reach

`GET /v1/integrations/accounts/{account_id}/scope/site-options`

## Request

- Base URL: `https://api.patricia.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.patricia.app/v1/integrations/accounts/{account_id}/scope/site-options`
- Auth: HTTP bearer

Suggestions for the site picker. Walks the connection's own site collections — keyword search, followed sites, and subsites recursively — and returns them deduplicated. Gated by the same rule as reading and replacing the policy, because the list names sites and so describes part of the estate. **This is never the whole estate**: the sources are followed sites and keyword matches, and a connection can reach a site that is neither, so offer a way to enter one that is not listed. ``sources_exhausted`` says only whether every request finished; false means even these sources were not fully read. ``search`` seeds the site-search source, which the provider requires a term for; followed sites and subsites are read without one.

## Path parameters

- `account_id` string, uuid, required

## Query parameters

- `search` string, nullable

## Headers

- `X-Tenant-Id` string, nullable

## Response `200`

Successful Response

- SiteOptionsResponse: Sites this connection was found to reach — never a claim about the whole estate. **There is no field saying this list is complete, because the sources cannot establish that.** They are the sites the person FOLLOWS and the sites matching a keyword; a connection can reach a site that is neither. Treat this as a set of suggestions to pick from, and let somebody enter a site it does not contain. ``sources_exhausted`` answers the smaller question: did every request finish, or did something stop part way. ``false`` means this list is shorter than even these sources would have given — worth telling a person, so they know to retry rather than conclude their estate is small. It is NOT permission to do anything, and in particular a ``true`` here licenses no narrowing. ``incomplete_reason`` is a bounded code, never provider text, so it can be logged and compared.
  - `sites` SiteOption[], required
    - `site_id` string, required
    - `display_name` string, nullable
    - `web_url` string, nullable
  - `sources_exhausted` boolean, required
  - `incomplete_reason` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/patricia/apis/patricia-api.md) · [All operations](https://skmtc.dev/patricia/apis/patricia-api/llms.txt) · [OpenAPI document](https://skmtc.dev/patricia/apis/patricia-api/revisions/0dfb44495ea1?raw)