Working with SharePoint sites

A site is a container — of drives, lists, pages, permissions and members. Start from a site's URL or server-relative path, then descend into whatever it holds. These examples cover discovery, administration, sharing and reporting. Requires Sites.Read.All to read, Sites.ReadWrite.All to change.

Get a site

Sites are addressed by URL or server-relative path, so you can use what you already have instead of looking up an id:

client.sites.root  # the tenant root site (lazy — chain .get())
client.sites.get_by_url("https://contoso.sharepoint.com/sites/marketing")  # by URL
client.sites.get_by_path("/sites/marketing")  # by server-relative path
client.sites["contoso.sharepoint.com:/sites/marketing"]  # by host + path key

get_by_url and get_by_path queue the read for you — just call execute_query() (no trailing .get()).

→ get_site.py · get_site_by_path.py · list_all.py · subsites.py

Permissions & sharing

site = client.sites.get_by_path("/sites/marketing").execute_query()
site.add_permission(...).execute_query()  # grant access
site.share("organization").execute_query()  # sharing link

→ site_permissions.py · grant_permission.py / revoke_permission.py · share_site_link.py · external_sharing.py

Admins & follow

site.admins.add(user).execute_query()
client.me.followed_sites.add(site.id).execute_query()

→ add_admin.py / remove_admin.py · search_and_follow.py · unfollow_site.py

Governance & reporting

Activity windows, stale-site detection, content-type/column inventory and CSV exports — the "keep the tenant tidy" toolbox.

→ analytics_report.py · site_activities.py · find_stale.py · stale_lifecycle.py · site_governance.py · storage_report.py · export_csv.py