Microsoft Graph Sites is the Graph API surface for SharePoint Online, letting apps discover and work with sites and their content through a single, secure endpoint. It enables you to locate the root site or a site by URL, search for sites, and navigate a site’s structure to access document libraries (drives), lists, list items, files, and modern site pages.
openapi: 3.1.0
info:
title: Microsoft Graph Sites
description: Needs a description.
paths:
/admin/edge/internetExplorerMode/siteLists/{browserSiteList-id}/sites:
description: >-
Provides operations to manage the sites property of the
microsoft.graph.browserSiteList entity.
get:
tags:
- Admin.edge
summary: Microsoft Graph List browserSites
description: Get a list of the browserSite objects and their properties.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/browsersitelist-list-sites?view=graph-rest-1.0
operationId: admin.edge.internetExplorerMode.siteLists.ListSites
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.browserSiteCollectionResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- Admin.edge
summary: Microsoft Graph Create browserSite
description: Create a new browserSite object in a browserSiteList.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/browsersitelist-post-sites?view=graph-rest-1.0
operationId: admin.edge.internetExplorerMode.siteLists.CreateSites
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.browserSite'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.browserSite'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: browserSiteList-id
in: path
description: The unique identifier of browserSiteList
required: true
schema:
type: string
x-ms-docs-key-type: browserSiteList
/admin/edge/internetExplorerMode/siteLists/{browserSiteList-id}/sites/{browserSite-id}:
description: >-
Provides operations to manage the sites property of the
microsoft.graph.browserSiteList entity.
get:
tags:
- Admin.edge
summary: Microsoft Graph Get browserSite
description: Get a browserSite that resides on a browserSiteList.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/browsersite-get?view=graph-rest-1.0
operationId: admin.edge.internetExplorerMode.siteLists.GetSites
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.browserSite'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- Admin.edge
summary: Microsoft Graph Update browserSite
description: Update the properties of a browserSite object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/browsersite-update?view=graph-rest-1.0
operationId: admin.edge.internetExplorerMode.siteLists.UpdateSites
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.browserSite'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.browserSite'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- Admin.edge
summary: Microsoft Graph Delete browserSite
description: Delete a browserSite from a browserSiteList.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/browsersitelist-delete-sites?view=graph-rest-1.0
operationId: admin.edge.internetExplorerMode.siteLists.DeleteSites
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: browserSiteList-id
in: path
description: The unique identifier of browserSiteList
required: true
schema:
type: string
x-ms-docs-key-type: browserSiteList
- name: browserSite-id
in: path
description: The unique identifier of browserSite
required: true
schema:
type: string
x-ms-docs-key-type: browserSite
/admin/edge/internetExplorerMode/siteLists/{browserSiteList-id}/sites/$count:
description: Provides operations to count the resources in the collection.
get:
tags:
- Admin.edge
summary: Microsoft Graph Get the number of the resource
operationId: admin.edge.internetExplorerMode.siteLists.sites.GetCount-da97
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
parameters:
- name: browserSiteList-id
in: path
description: The unique identifier of browserSiteList
required: true
schema:
type: string
x-ms-docs-key-type: browserSiteList
/groups/{group-id}/sites:
description: >-
Provides operations to manage the sites property of the
microsoft.graph.group entity.
get:
tags:
- Groups.site
summary: Microsoft Graph Get sites from groups
description: >-
The list of SharePoint sites in this group. Access the default site with
/sites/root.
operationId: groups.ListSites
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: '#/components/responses/microsoft.graph.siteCollectionResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
schema:
type: string
x-ms-docs-key-type: group
/groups/{group-id}/sites/{site-id}:
description: >-
Provides operations to manage the sites property of the
microsoft.graph.group entity.
get:
tags:
- Groups.site
summary: Microsoft Graph Get sites from groups
description: >-
The list of SharePoint sites in this group. Access the default site with
/sites/root.
operationId: groups.GetSites
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.site'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- Groups.site
summary: Microsoft Graph Update the navigation property sites in groups
operationId: groups.UpdateSites
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.site'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.site'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
schema:
type: string
x-ms-docs-key-type: group
- name: site-id
in: path
description: The unique identifier of site
required: true
schema:
type: string
x-ms-docs-key-type: site
/groups/{group-id}/sites/{site-id}/analytics:
description: >-
Provides operations to manage the analytics property of the
microsoft.graph.site entity.
get:
tags:
- Groups.site
summary: Microsoft Graph Get analytics from groups
description: Analytics about the view activities that took place on this site.
operationId: groups.sites.GetAnalytics
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- Groups.site
summary: Microsoft Graph Update the navigation property analytics in groups
operationId: groups.sites.UpdateAnalytics
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemAnalytics'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- Groups.site
summary: Microsoft Graph Delete navigation property analytics for groups
operationId: groups.sites.DeleteAnalytics
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
schema:
type: string
x-ms-docs-key-type: group
- name: site-id
in: path
description: The unique identifier of site
required: true
schema:
type: string
x-ms-docs-key-type: site
x-ms-docs-grouped-path:
- /groups/{group-id}/sites/{site-id}/getByPath(path='{path}')/analytics
/groups/{group-id}/sites/{site-id}/analytics/allTime:
description: >-
Provides operations to manage the allTime property of the
microsoft.graph.itemAnalytics entity.
get:
tags:
- Groups.site
summary: Microsoft Graph Get allTime from groups
operationId: groups.sites.analytics.GetAllTime
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
schema:
type: string
x-ms-docs-key-type: group
- name: site-id
in: path
description: The unique identifier of site
required: true
schema:
type: string
x-ms-docs-key-type: site
/groups/{group-id}/sites/{site-id}/analytics/itemActivityStats:
description: >-
Provides operations to manage the itemActivityStats property of the
microsoft.graph.itemAnalytics entity.
get:
tags:
- Groups.site
summary: Microsoft Graph Get itemActivityStats from groups
operationId: groups.sites.analytics.ListItemActivityStats
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.itemActivityStatCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- Groups.site
summary: Microsoft Graph Create new navigation property to itemActivityStats for groups
operationId: groups.sites.analytics.CreateItemActivityStats
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
schema:
type: string
x-ms-docs-key-type: group
- name: site-id
in: path
description: The unique identifier of site
required: true
schema:
type: string
x-ms-docs-key-type: site
/groups/{group-id}/sites/{site-id}/analytics/itemActivityStats/{itemActivityStat-id}:
description: >-
Provides operations to manage the itemActivityStats property of the
microsoft.graph.itemAnalytics entity.
get:
tags:
- Groups.site
summary: Microsoft Graph Get itemActivityStats from groups
operationId: groups.sites.analytics.GetItemActivityStats
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- Groups.site
summary: Microsoft Graph Update the navigation property itemActivityStats in groups
operationId: groups.sites.analytics.UpdateItemActivityStats
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivityStat'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- Groups.site
summary: Microsoft Graph Delete navigation property itemActivityStats for groups
operationId: groups.sites.analytics.DeleteItemActivityStats
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
schema:
type: string
x-ms-docs-key-type: group
- name: site-id
in: path
description: The unique identifier of site
required: true
schema:
type: string
x-ms-docs-key-type: site
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
schema:
type: string
x-ms-docs-key-type: itemActivityStat
/groups/{group-id}/sites/{site-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities:
description: >-
Provides operations to manage the activities property of the
microsoft.graph.itemActivityStat entity.
get:
tags:
- Groups.site
summary: Microsoft Graph Get activities from groups
description: >-
Exposes the itemActivities represented in this itemActivityStat
resource.
operationId: groups.sites.analytics.itemActivityStats.ListActivities
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.itemActivityCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- Groups.site
summary: Microsoft Graph Create new navigation property to activities for groups
operationId: groups.sites.analytics.itemActivityStats.CreateActivities
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
schema:
type: string
x-ms-docs-key-type: group
- name: site-id
in: path
description: The unique identifier of site
required: true
schema:
type: string
x-ms-docs-key-type: site
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
schema:
type: string
x-ms-docs-key-type: itemActivityStat
/groups/{group-id}/sites/{site-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}:
description: >-
Provides operations to manage the activities property of the
microsoft.graph.itemActivityStat entity.
get:
tags:
- Groups.site
summary: Microsoft Graph Get activities from groups
description: >-
Exposes the itemActivities represented in this itemActivityStat
resource.
operationId: groups.sites.analytics.itemActivityStats.GetActivities
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- Groups.site
summary: Microsoft Graph Update the navigation property activities in groups
operationId: groups.sites.analytics.itemActivityStats.UpdateActivities
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.itemActivity'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- Groups.site
summary: Microsoft Graph Delete navigation property activities for groups
operationId: groups.sites.analytics.itemActivityStats.DeleteActivities
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
schema:
type: string
x-ms-docs-key-type: group
- name: site-id
in: path
description: The unique identifier of site
required: true
schema:
type: string
x-ms-docs-key-type: site
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
description: The unique identifier of itemActivity
required: true
schema:
type: string
x-ms-docs-key-type: itemActivity
? /groups/{group-id}/sites/{site-id}/analytics/itemActivityStats/{itemActivityStat-id}/activities/{itemActivity-id}/driveItem
: description: >-
Provides operations to manage the driveItem property of the
microsoft.graph.itemActivity entity.
get:
tags:
- Groups.site
summary: Microsoft Graph Get driveItem from groups
description: Exposes the driveItem that was the target of this activity.
operationId: groups.sites.analytics.itemActivityStats.activities.GetDriveItem
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.driveItem'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: group-id
in: path
description: The unique identifier of group
required: true
schema:
type: string
x-ms-docs-key-type: group
- name: site-id
in: path
description: The unique identifier of site
required: true
schema:
type: string
x-ms-docs-key-type: site
- name: itemActivityStat-id
in: path
description: The unique identifier of itemActivityStat
required: true
schema:
type: string
x-ms-docs-key-type: itemActivityStat
- name: itemActivity-id
in: path
descri
# --- truncated at 32 KB (4729 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/sites-openapi-original.yml