Updates from: 08/28/2021 03:15:26
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Application Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-get.md
Title: "Get application" description: "Get the properties and relationships of an application object."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "applications" doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
GET /applications/{id} ``` ## Optional query parameters
-This method supports the `$select` [OData query parameter](/graph/query-parameters) to retrieve specific application properties.
+This method supports the `$select` [OData query parameter](/graph/query-parameters) to retrieve specific application properties.
## Request headers | Name | Description | |:|:|
GET https://graph.microsoft.com/beta/applications/{id}
### Response
-Here is an example of the response.
+Here is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Application List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-list.md
Title: "List applications" description: "Get the list of applications in this organization."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "applications" doc_type: apiPageType
Get the list of [applications](../resources/application.md) in this organization
> [!NOTE] > When calling this API using tokens issued for a personal Microsoft account, it will return the apps owned by the personal Microsoft account. The notion of organizations doesn't exist for personal Microsoft accounts. In order to list applications owned by specific personal Microsoft accounts, this API requires User.Read permission in addition to Application.Read.All or Application.ReadWrite.All.
-
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 Application Post Applications https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-applications.md
Title: "Create application" description: "Create a new application."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
Content-length: 67
### Response
-Here is an example of the response.
+Here is an example of the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Application Post Onlinemeetings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/application-post-onlinemeetings.md
Title: "Create onlineMeeting" description: "Create an online meeting on behalf of a user specified in the request body."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "cloud-communications" doc_type: apiPageType
Content-Type: application/json
#### Response
->**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
Content-Type: application/json
"joinInformation": { "content": "data%3Atext%2Fhtml%2C%0A++%3Cdiv+style%3D%22width%3A100%25%3Bheight%3A+20px%3B%22%3E%0A%09%09%3Cspan+style%3D%22white-space%3Anowrap%3Bcolor%3Agray%3Bopacity%3A.36%3B%22%3E________________________________________________________________________________%3C%2Fspan%3E%0A%09+%3C%2Fdiv%3E%0A++++%3Cdiv+class%3D%22me-email-text%22+style%3D%22color%3A%23252424%3Bfont-family%3A'Segoe+UI'%2C'Helvetica+Neue'%2CHelvetica%2CArial%2Csans-serif%3B%22%3E%0A+++%3Cdiv+style%3D%22margin-top%3A+24px%3B+margin-bottom%3A+10px%3B%22%3E%0A++++++++%3Ca+class%3D%22me-email-headline%22%0A++++++++++++++style%3D%22font-size%3A+18px%3Bfont-family%3A'Segoe+UI+Semibold'%2C'Segoe+UI'%2C'Helvetica+Neue'%2CHelvetica%2CArial%2Csans-serif%3Btext-decoration%3A+underline%3Bcolor%3A+%236264a7%3B%22%0A++++++++++++++href%3D%22https%3A%2F%2Fteams.microsoft.com%2Fl%2Fmeetup-join%2F19%253ameeting_NDRiZjRiMmUtODI5OC00MzRlLTk1ZWEtMGY1000000000000%2540thread.v2%2F0%3Fcontext%3D%257b%2522Tid%2522%253a%252279a788bf-86f1-41af-91ab-000000000000%2522%252c%2522Oid%2522%253a%2522d4a060b5-a8fc-450c-837b-000000000000%2522%257d%22%0A++++++++++++++target%3D%22_blank%22+rel%3D%22noreferrer+noopener%22%3EMicrosoft+Teams+%E4%BC%9A%E8%AD%B0%E3%81%AB%E5%8F%82%E5%8A%A0%3C%2Fa%3E%0A++++++%3C%2Fdiv%3E%0A%09+%3Cdiv%3E%0A++++%0A++++++%3Cdiv%3E%0A++++++++%3Ca+class%3D%22me-email-link%22+style%3D%22font-size%3A+14px%3Btext-decoration%3A+none%3Bcolor%3A+%236264a7%3B%22%0A++++++++++href%3D%22tel%3A%2B16477490000%2C%2C11160000%26%2335%3B+%22+target%3D%22_blank%22+rel%3D%22noreferrer+noopener%22%3E%2B16477490000%3C%2Fa%3E%0A++++++%3Cspan+style%3D%22font-size%3A+12px%3B%22%3E%26nbsp%3B++(%E6%9C%89%E6%96%99)+%3C%2Fspan%3E%0A++++++%3C%2Fdiv%3E%0A++++%0A++%3C%2Fdiv%3E%0A%0A%09+%0A++++++%3Cdiv+style%3D%22margin-top%3A+10px%3B+margin-bottom%3A+20px%3B%22%3E%0A++++++++%3Cspan+style%3D%22font-size%3A+12px%3B%22%3E%0A++++++++++%E4%BC%9A%E8%AD%B0+ID%3A%0A++++++++%3C%2Fspan%3E%0A++++++%3Cspan+style%3D%22font-size%3A+14px%3B%22%3E%0A++++++++111+000+00%23%0A++++++%3C%2Fspan%3E%0A++++%3C%2Fdiv%3E%0A++++%0A%09+%0A++++++++%3Cdiv+style%3D%22margin-bottom%3A+24px%3B%22%3E%0A++++++++++++++%3Ca+class%3D%22me-email-link%22+style%3D%22font-size%3A+12px%3Btext-decoration%3A+none%3Bcolor%3A+%236264a7%3B%22+target%3D%22_blank%22+href%3D%22https%3A%2F%2Fdialin.teams.microsoft.com%2F8bf6e654-57eb-4b85-aeaf-36c84429b2fe%3Fid%3D11160000%22+rel%3D%22noreferrer+noopener%22%3E%E6%9C%80%E5%AF%84%E3%82%8A%E3%81%AE%E5%9B%BD%E3%81%AE%E9%9B%BB%E8%A9%B1%E7%95%AA%E5%8F%B7%E3%82%92%E6%A4%9C%E7%B4%A2%3C%2Fa%3E%0A+++++++++%7C%0A++++++++++++++%3Ca+class%3D%22me-email-link%22+style%3D%22font-size%3A+12px%3Btext-decoration%3A+none%3Bcolor%3A+%236264a7%3B%22+target%3D%22_blank%22+href%3D%22https%3A%2F%2Fmysettings.lync.com%2Fpstnconferencing%22+rel%3D%22noreferrer+noopener%22%3E%0A++++++++PIN+%E3%82%92%E3%83%AA%E3%82%BB%E3%83%83%E3%83%88%3C%2Fa%3E%0A+++++++++%7C+%3Ca+class%3D%22me-email-link%22+style%3D%22font-size%3A+12px%3Btext-decoration%3A+none%3Bcolor%3A+%236264a7%3B%22+target%3D%22_blank%22+href%3D%22https%3A%2F%2Faka.ms%2FJoinTeamsMeeting%22+rel%3D%22noreferrer+noopener%22%3ETeams+%E3%81%AE%E8%A9%B3%E7%B4%B0%E3%82%92%E8%A1%A8%E7%A4%BA%3C%2Fa%3E%0A+++++%7C+%3Ca+class%3D%22me-email-link%22+style%3D%22font-size%3A+12px%3Btext-decoration%3A+none%3Bcolor%3A+%236264a7%3B%22+target%3D%22_blank%22+href%3D%22https%3A%2F%2Fteams.microsoft.com%2FmeetingOptions%2F%3ForganizerId%3Dd4a060b5-a8fc-450c-837b-000000000000%26tenantId%3D79a788bf-86f1-41af-91ab-000000000000%26threadId%3D19_meeting_NDRiZjRiMmUtODI5OC00MzRlLTk1ZWEtMGY1000000000000%40thread.v2%26messageId%3D0%26language%3Dja%22+rel%3D%22noreferrer+noopener%22%3E%E4%BC%9A%E8%AD%B0%E3%81%AE%E3%82%AA%E3%83%97%E3%82%B7%E3%83%A7%E3%83%B3%3C%2Fa%3E%0A++++%0A++++++++%3C%2Fdiv%3E%0A++++%0A+++++%0A++++++++%3Cdiv+style%3D%22font-size%3A+14px%3B+margin-bottom%3A+4px%3B%22%3E%0A++++++++++++%E3%83%93%E3%83%87%E3%82%AA%E4%BC%9A%E8%AD%B0%E3%83%87%E3%83%90%E3%82%A4%E3%82%B9%E3%81%A7%E5%8F%82%E5%8A%A0%0A++++++++%3C%2Fdiv%3E%0A%0A++++++++%3Cdiv+style%3D%22font-size%3A12px%3B+margin-bottom%3A+4px%3B%22%3E%0A++++++++++++%3Ca+class%3D%22me-email-link%22+style%3D%22text-decoration%3A+none%3Bcolor%3A+%236264a7%3B%22+href%3D%22%22%3E000000000%40t.abcd.vc%3C%2Fa%3E+VTC+%E4%BC%9A%E8%AD%B0+ID%3A+0180300000%0A++++++++%3C%2Fdiv%3E%0A%0A++++++++%3Cdiv+style%3D%22font-size%3A+12px%3B+margin-bottom%3A+20px%3B%22%3E%0A++++++++%3Ca+class%3D%22me-email-link%22+style%3D%22text-decoration%3A+none%3Bcolor%3A+%236264a7%3B%22+href%3D%22https%3A%2F%2Fdialin.abcd.vc%2Fteams%2F%3Fkey%3D000000000%26conf%3D0180308922%22%3E%E4%BB%A3%E6%9B%BF+VTC+%E3%81%AE%E3%83%80%E3%82%A4%E3%83%A4%E3%83%AB%E6%96%B9%E6%B3%95%3C%2Fa%3E%0A++++++++%3C%2Fdiv%3E%0A++++%0A+++++%0A++++++%3Cdiv+style%3D%22font-size%3A+14px%3B+margin-bottom%3A+4px%3B%22%3E%0A++++++++%0A++++++%3C%2Fdiv%3E%0A++++++%3Cdiv+style%3D%22font-size%3A+12px%3B%22%3E%0A++++++%0A++++++%3C%2Fdiv%3E%0A++++%0A+++++%3C%2Fdiv%3E%0A%09+%3Cdiv+style%3D%22width%3A100%25%3Bheight%3A+20px%3B%22%3E%0A%09%09%3Cspan+style%3D%22white-space%3Anowrap%3Bcolor%3Agray%3Bopacity%3A.36%3B%22%3E________________________________________________________________________________%3C%2Fspan%3E%0A++%3C%2Fdiv%3E%22%2C%0A", "contentType": "Html"
- }
+ }
```
v1.0 Authenticationflowspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationflowspolicy-get.md
Title: "Get authenticationFlowsPolicy" description: "Read the properties and relationships of an authenticationFlowsPolicy object."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 Authenticationflowspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/authenticationflowspolicy-update.md
Title: "Update authenticationFlowsPolicy" description: "Update the Boolean selfServiceSignUp property of an authenticationFlowsPolicy object."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "identity-and-sign-in" doc_type: apiPageType
v1.0 B2cauthenticationmethodspolicy Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cauthenticationmethodspolicy-get.md
Title: "Get b2cAuthenticationMethodsPolicy" description: "Read the properties of a b2cAuthenticationMethodsPolicy object."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 B2cauthenticationmethodspolicy Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/b2cauthenticationmethodspolicy-update.md
Title: "Update b2cAuthenticationMethodsPolicy" description: "Update properties of a b2cAuthenticationMethodsPolicy object."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "identity-and-sign-in" doc_type: "apiPageType"
v1.0 Calendar Getschedule https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/calendar-getschedule.md
Title: "calendar: getSchedule" description: "Get the free/busy availability information for a collection of users, distributions lists, or resources, for a specified time period."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "outlook" doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /me/calendar/getSchedule
+POST /me/calendar/getSchedule
POST /users/{id|userPrincipalName}/calendar/getSchedule ```
The following example gets the availability information for two users for the sp
"name": "calendar_getSchedule" }--> ```http
-POST https://graph.microsoft.com/beta/me/calendar/getSchedule
+POST https://graph.microsoft.com/beta/me/calendar/getSchedule
Prefer: outlook.timezone="Pacific Standard Time" Content-Type: application/json
-{
+{
"schedules": ["adelev@contoso.onmicrosoft.com", "meganb@contoso.onmicrosoft.com"], "startTime": { "dateTime": "2019-03-15T09:00:00",
v1.0 Channel Get Filesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/channel-get-filesfolder.md
Title: "Get filesFolder" description: "Retrieve the filesFolder navigation path of a channel."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the metadata for the location where the files of a [channel](../resources/channel.md) are stored.
+Get the metadata for the location where the files of a [channel](../resources/channel.md) are stored.
## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
GET https://graph.microsoft.com/beta/teams/{id}/channels/{id}/filesFolder
### Response
-The following is an example of the response.
+The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Channel Get Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/channel-get-members.md
Title: "Get member of channel" description: "Get member of channel."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
GET https://graph.microsoft.com/beta/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d82/
Here is an example of the response.
->**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Channel Getallmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/channel-getallmessages.md
Title: "channel: getAllMessages" description: "Retrieve all messages across channels in a team."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve [messages](../resources/chatmessage.md) across all [channels](../resources/channel.md) in a [team](../resources/team.md), including text, audio, and video conversations.
+Retrieve [messages](../resources/chatmessage.md) across all [channels](../resources/channel.md) in a [team](../resources/team.md), including text, audio, and video conversations.
To learn more about using the Microsoft Teams export APIs to export content, see [Export content with the Microsoft Teams export APIs](/microsoftteams/export-teams-content).
v1.0 Channel List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/channel-list-members.md
Title: "List members of channel" description: "List members of a channel."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
GET https://graph.microsoft.com/beta/teams/2ab9c796-2902-45f8-b712-7c5a63cf41c4/
Here is an example of the response.
->**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Channel List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/channel-list-messages.md
Title: "List channel messages" description: "Retrieve the list of messages (without the replies) in a channel of a team. To get the replies for a message, call the list message replies or the get message reply API. "
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Retrieve the list of [messages](../resources/chatmessage.md) (without the replies) in a [channel](../resources/channel.md) of a [team](../resources/team.md).
+Retrieve the list of [messages](../resources/chatmessage.md) (without the replies) in a [channel](../resources/channel.md) of a [team](../resources/team.md).
-To get the replies for a message, call the [list message replies](chatmessage-list-replies.md) or the [get message reply](chatmessage-get.md) API.
+To get the replies for a message, call the [list message replies](chatmessage-list-replies.md) or the [get message reply](chatmessage-get.md) API.
> **Note**: This API supports subscribing to changes (create, update, and delete) using [change notifications](../resources/webhooks.md). This allows callers to subscribe and get changes in real time. For details, see [Get notifications for messages](/graph/teams-changenotifications-chatmessage).
v1.0 Channel List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/channel-list.md
Title: "List channels"
description: "Retrieve the list of channels in this team." doc_type: "apiPageType"
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams"
v1.0 Chat Delete Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-delete-installedapps.md
Title: "Uninstall app in a chat" description: "Uninstall (remove) an app installed in a chat."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-<!-- {
-"blockType": "ignored"
+<!-- {
+"blockType": "ignored"
} --> ```http
v1.0 Chat Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-delete-members.md
Title: "Remove member from chat" description: "Remove a conversationMember from a chat."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Chat Get Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-get-installedapps.md
Title: "Get installed app in chat" description: "Get installed app in a chat."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-<!-- {
-"blockType": "ignored"
+<!-- {
+"blockType": "ignored"
} --> ```http
v1.0 Chat Get Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-get-members.md
Title: "Get conversationMember in a chat" description: "Retrieve a member of a chat."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
GET https://graph.microsoft.com/beta/chats/19:b8577894a63548969c5c92bb9c80c5e1@t
Here is an example of the response.
-<!--
+<!--
{ "blockType": "response", "truncated": true,
v1.0 Chat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-get.md
Title: "Get chat" description: "Retrieve a single chat."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Chat List Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list-installedapps.md
Title: "List apps in chat" description: "List the apps installed in a chat."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
GET https://graph.microsoft.com/beta/chats/19%3Ad65713bc498c4a428c71ef9353e6ce20
The following is an example of the response.
->**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "name": "list_installed_apps_in_chat_expand_filter",
v1.0 Chat List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list-members.md
Title: "List members of a chat" description: "Retrieve members of a chat."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list-messages.md
Title: "List messages in a chat" description: "Retrieve the list of messages in a chat. "
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Chat List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list-permissiongrants.md
Title: "List permissionGrants of a chat" description: "Retrieve permissionGrants of a chat."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Chat Post Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-post-installedapps.md
Title: "Add app to chat" description: "Install an app to chat."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
One of the following permissions is required to call this API. To learn more, in
## HTTP request
-<!-- {
-"blockType": "ignored"
+<!-- {
+"blockType": "ignored"
} --> ```http
v1.0 Chat Teamsappinstallation Upgrade https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-teamsappinstallation-upgrade.md
Title: "teamsAppInstallation: upgrade" description: "Update an app installed in a chat and bring it in sync with the current version available in the tenant app catalog."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Chatmessage Delta https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessage-delta.md
Title: "chatMessage: delta" description: "Retrieve the list of messages (without the replies) in a channel of a team. By using delta query, you can get new or updated messages in a channel."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "microsoft-teams"
v1.0 Chatmessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessage-get.md
Title: "Get chatMessage in a channel or chat" description: "Retrieve a single message (without its replies) in a channel or a chat."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Chats Getallmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chats-getallmessages.md
Title: "chats: getAllMessages" description: "Get messages from all chats that a user is a participant in."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
GET https://graph.microsoft.com/beta/users/8b081ef6-4792-4def-b2c9-c363a1bf41d5/
### Response
->**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true, "@odata.type": "microsoft.graph.chatMessage" } --> ```http
-HTTP/1.1 200 OK
-Content-type: application/json
-Content-length: 347
+HTTP/1.1 200 OK
+Content-type: application/json
+Content-length: 347
{ "@odata.context":"https://graph.microsoft.com/beta/$metadata#Collection(chatMessage)",
Content-length: 347
"content":"<div>\n<blockquote itemscope=\"\" itemtype=\"http://schema.skype.com/Reply\" itemid=\"1600457867820\">\n<strong itemprop=\"mri\" itemid=\"8:orgid:0de69e5e-2da8-4cf2-821f-5e6585b2c65b\">Richard Wilson</strong><span itemprop=\"time\" itemid=\"1600457867820\"></span>\n<p itemprop=\"preview\">1237</p>\n</blockquote>\n<p>this is a reply</p>\n</div>" }, "attachments":[
-
+ ], "mentions":[
-
+ ], "reactions":[
-
+ ] } ]
v1.0 Conversationmembers Add https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/conversationmembers-add.md
Title: "conversationMember: add"
description: "Add members in bulk to team." doc_type: "apiPageType"
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams"
Add multiple members in a single request to a [team](../resources/team.md). The
One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-|Permission type | Permissions (from least to most privileged) |
+|Permission type | Permissions (from least to most privileged) |
|:--|:--| | Delegated (work or school account) | TeamMember.ReadWrite.All | | Delegated (personal Microsoft account) | Not supported |
Content-Type: application/json
The following is the response.
-> **Note:** The response object shown here might be shortened for readability.
+> **Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
Content-Type: application/json
The following is the response.
-> **Note:** The response object shown here might be shortened for readability.
+> **Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Group Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-get.md
Title: "Get group" description: "Get the properties and relationships of a group object."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "groups" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the properties and relationships of a [group](../resources/group.md) object.
+Get the properties and relationships of a [group](../resources/group.md) object.
This operation returns by default only a subset of all the available properties, as noted in the [Properties](../resources/group.md#properties) section. To get properties that are _not_ returned by default, specify them in a `$select` OData query option. The **hasMembersWithLicenseErrors** property is an exception and is not returned in the `$select` query. Because the **group** resource supports [extensions](/graph/extensibility-overview), you can also use the `GET` operation to get custom properties and extension data in a **group** instance.
If successful, this method returns a `200 OK` response code and [group](../resou
#### Request
-The following is an example of a GET request.
+The following is an example of a GET request.
# [HTTP](#tab/http) <!-- {
Content-type: application/json
#### Request
-The following is an example of a GET request.
+The following is an example of a GET request.
# [HTTP](#tab/http)
v1.0 Group List Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list-approleassignments.md
Title: "List appRoleAssignments granted to a group" description: "Retrieve the list of appRoleAssignments that have been granted to a group."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "groups"
v1.0 Group List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list-permissiongrants.md
Title: "List permissionGrants of a group" description: "Retrieve permissionGrants of a group."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Group List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-list.md
Title: "List groups" description: "List all the groups available in an organization, including but not limited to Microsoft 365 groups."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "groups" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-List all the groups in an organization, including but not limited to Microsoft 365 groups.
+List all the groups in an organization, including but not limited to Microsoft 365 groups.
This operation returns by default only a subset of the more commonly used properties for each group. These _default_ properties are noted in the [Properties](../resources/group.md#properties) section. To get properties that are _not_ returned by default, do a [GET operation](group-get.md) for the group and specify the properties in a `$select` OData query option. The **hasMembersWithLicenseErrors** property is an exception and is not returned in the `$select` query.
Content-type: application/json
"renewedDateTime":"2018-11-19T20:29:40Z", "resourceBehaviorOptions":[ ],
- "resourceProvisioningOptions":[
+ "resourceProvisioningOptions":[
], "securityEnabled":false, "theme":null,
v1.0 Group Post Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-post-approleassignments.md
Title: "Grant an appRoleAssignment to a group" description: "Grant an app role assignment to a group."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "groups"
In this example, `{id}` and `{principalId-value}` would both be the `id` of the
### Response
-Here is an example of the response.
+Here is an example of the response.
>**Note:** The response object shown here might be shortened for readability.
v1.0 Group Post Groups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/group-post-groups.md
Title: "Create group" description: "Create a new Microsoft 365 group or security group."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "groups" doc_type: apiPageType
POST /groups
## Request body
-The following table shows the properties of the [group](../resources/group.md) resource to specify when you create a group.
+The following table shows the properties of the [group](../resources/group.md) resource to specify when you create a group.
| Property | Type | Description| |:|:--|:-|
Because the **group** resource supports [extensions](/graph/extensibility-overvi
>**Note:** Creating a group using the Group.Create application permission without specifying owners will create the group anonymously and the group will not be modifiable. You can use the `POST` operation and add owners to the group while creating it to specify owners who can modify the group.
-> Creating a Microsoft 365 group programmatically with an app-only context and without specifying owners will create the group anonymously. Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken.
+> Creating a Microsoft 365 group programmatically with an app-only context and without specifying owners will create the group anonymously. Doing so can result in the associated SharePoint Online site not being created automatically until further manual action is taken.
Specify other writable properties as necessary for your group. For more information, see the properties of the [group](../resources/group.md) resource.
Content-Type: application/json
} ```
-#### Response
+#### Response
-The following is an example of a successful response. It includes only default properties. You can subsequently get the **owners** or **members** navigation properties of the group to verify the owner or members.
+The following is an example of a successful response. It includes only default properties. You can subsequently get the **owners** or **members** navigation properties of the group to verify the owner or members.
>**Note:** The response object shown here might be shortened for readability.
v1.0 Profilephoto Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/profilephoto-get.md
Title: "Get photo" description: "Get the specified profilePhoto or its metadata (**profilePhoto** properties)."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: ""
v1.0 Rbacapplication List Roleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/rbacapplication-list-roleassignments.md
To list role assignments for the entitlement management provider:
GET /roleManagement/entitlementManagement/roleAssignments?$filter=principalId eq '{principal id}' GET /roleManagement/entitlementManagement/roleAssignments?$filter=roleDefinitionId eq '{roleDefinition id}'+
+GET /roleManagement/entitlementManagement/roleAssignments?$filter=appScopeId eq '/accessPackageCatalog/{catalog id}'
``` ## Query parameters
v1.0 Samlorwsfedexternaldomainfederation Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-delete.md
+
+ Title: "Delete samlOrWsFedExternalDomainFederation"
+description: "Delete a samlOrWsFedExternalDomainFederation object."
+
+localization_priority: medium
++
+# Delete samlOrWsFedExternalDomainFederation
+Namespace: microsoft.graph
++
+Delete a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account)|Domain.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application|Domain.ReadWrite.All|
+
+The work or school account needs to belong to one of the following [Azure Active Directory (Azure AD) roles](/azure/active-directory/roles/permissions-reference):
+
+* Global Administrator
+* External Identity Provider Administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+DELETE directory/federationConfigurations/{samlOrWsFedExternalDomainFederation ID}
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_samlorwsfedexternaldomainfederation"
+}
+-->
+
+``` http
+DELETE https://graph.microsoft.com/beta/directory/federationConfigurations/96db02e2-80c1-5555-bc3a-de92ffb8c5be
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+``` http
+HTTP/1.1 204 No Content
+```
v1.0 Samlorwsfedexternaldomainfederation Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-get.md
+
+ Title: "Get samlOrWsFedExternalDomainFederation"
+description: "Read the properties and relationships of a samlOrWsFedExternalDomainFederation object."
+
+localization_priority: medium
++
+# Get samlOrWsFedExternalDomainFederation
+Namespace: microsoft.graph
++
+Read the properties and relationships of a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object for a specific [externalDomainName](../resources/externaldomainname.md).
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account)|Domain.Read.All, Domain.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application|Domain.Read.All, Domain.ReadWrite.All|
+
+The work or school account needs to belong to one of the following [Azure Active Directory (Azure AD) roles](/azure/active-directory/roles/permissions-reference):
+
+* Global Administrator
+* External Identity Provider Administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation?$filter=domains/any(x: x/id eq 'domainName-value')
+```
+
+## Query parameters
+
+This method requires the `$filter` OData query parameter. To retrieve a specific [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) filter based on [externalDomainName](../resources/externaldomainname.md), add `?$filter=domains/any(x: x/id eq 'domainName-value')`.
+
+For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_samlorwsfedexternaldomainfederation"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation?$filter=domains/any(x: x/id eq 'contoso.com')
+```
+
+### Response
+
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.samlOrWsFedExternalDomainFederation"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "96db02e2-80c1-5555-bc3a-de92ffb8c5be",
+ "displayName": "Contoso",
+ "issuerUri": "http://contoso.com/adfs/services/trust",
+ "metadataExchangeUri": null,
+ "signingCertificate": "MIIC6DCCAdCgAwIBAgIQQ6vYJIVKQ",
+ "passiveSignInUri": "https://contoso.com/adfs/ls/",
+ "preferredAuthenticationProtocol": "saml",
+ "domains": [
+ {
+ "id": "contoso.com"
+ }
+ ]
+ }
+ ]
+}
+
+```
v1.0 Samlorwsfedexternaldomainfederation List Domains https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-list-domains.md
+
+ Title: "List domains"
+description: "Get the list of all externalDomainName objects for a samlOrWsFedExternalDomainFederation."
+
+localization_priority: medium
++
+# List domains
+Namespace: microsoft.graph
++
+Get the list of all [externalDomainName](../resources/externaldomainname.md) objects for a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md).
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account)|Domain.Read.All, Domain.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application|Domain.Read.All, Domain.ReadWrite.All|
+
+The work or school account needs to belong to one of the following [Azure Active Directory (Azure AD) roles](/azure/active-directory/roles/permissions-reference):
+
+* Global Administrator
+* External Identity Provider Administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation/{samlOrWsFedExternalDomainFederation ID}/domains
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [externalDomainName](../resources/externaldomainname.md) objects in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "list_externaldomainname"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation/f1e11a04-0244-4592-99df-b01cfaadce15/domains
+```
+
+### Response
+
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.externalDomainName)"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft-ppe.com/beta/$metadata#directory/federationConfigurations/microsoft.graph.samlOrWsFedExternalDomainFederation('f1e11a04-0244-4592-99df-b01cfaadce15')/domains",
+ "value": [
+ {
+ "id": "fabrikam.com"
+ },
+ {
+ "id": "contoso.com"
+ }
+ ]
+}
+```
v1.0 Samlorwsfedexternaldomainfederation List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-list.md
+
+ Title: "List samlOrWsFedExternalDomainFederations"
+description: "Get a list of the samlOrWsFedExternalDomainFederation objects and their properties."
+
+localization_priority: medium
++
+# List samlOrWsFedExternalDomainFederations
+Namespace: microsoft.graph
++
+Get a list of the [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) objects and their properties.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account)|Domain.Read.All, Domain.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application|Domain.Read.All, Domain.ReadWrite.All|
+
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* External Identity Provider Administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+GET /directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) objects in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "list_samlorwsfedexternaldomainfederation"
+}
+-->
+
+``` http
+GET https://graph.microsoft.com/beta/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation
+```
+
+### Response
+
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.samlOrWsFedExternalDomainFederation)"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "value": [
+ {
+ "id": "96db02e2-80c1-5555-bc3a-de92ffb8c5be",
+ "displayName": "Contoso",
+ "issuerUri": "http://contoso.com/adfs/services/trust",
+ "metadataExchangeUri": null,
+ "signingCertificate": "MIIC6DCCAdCgAwIBAgIQQ6vYJIVKQ",
+ "passiveSignInUri": "https://contoso.com/adfs/ls/",
+ "preferredAuthenticationProtocol": "saml",
+ "domains": [
+ {
+ "id": "contoso.com"
+ }
+ ]
+ },
+ {
+ "id": "fa421032-5d40-5555-a428-a304b4bc18b6",
+ "displayName": "Fabrikam",
+ "issuerUri": "https://fabrikam.com/o/saml2?idpid=C018555d",
+ "metadataExchangeUri": null,
+ "signingCertificate": "MIIDdDCCAlygAwIBAgIGAXowJih/",
+ "passiveSignInUri": "https://fabrikam.com/o/saml2/saml2?idpid=C018555d",
+ "preferredAuthenticationProtocol": "wsFed",
+ "domains": [
+ {
+ "id": "fabrikam.com",
+
+ }
+ ]
+ }
+ ]
+}
+```
v1.0 Samlorwsfedexternaldomainfederation Post Domains https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-post-domains.md
+
+ Title: "Create externalDomainName"
+description: "Create a new externalDomainName object."
+
+localization_priority: medium
++
+# Create externalDomainName
+Namespace: microsoft.graph
++
+Add multiple domains to your SAML or WS-Fed based configuration by creating a new [externalDomainName](../resources/externaldomainname.md) object and add it to an existing [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md).
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account)|Domain.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application|Domain.ReadWrite.All|
+
+The work or school account needs to belong to one of the following [Azure Active Directory (Azure AD) roles](/azure/active-directory/roles/permissions-reference):
+
+* Global Administrator
+* External Identity Provider Administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /directory/federationConfigurations/{samlOrWsFedExternalDomainFederation ID}/microsoft.graph.samlOrWsFedExternalDomainFederation/domains
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the [externalDomainName](../resources/externaldomainname.md) object.
+
+The following table shows the properties that are required when you create the [externalDomainName](../resources/externaldomainname.md).
+
+|Property|Type|Description|
+|:|:|:|
+|id|String|Domain name of the external organization you want to add to your [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md). Inherited from [entity](../resources/entity.md).|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and an [externalDomainName](../resources/externaldomainname.md) object in the response body.
+
+## Examples
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "create_externaldomainname_from_"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/directory/federationConfigurations/d5a56845-6845-d5a5-4568-a5d54568a5d5/microsoft.graph.samlOrWsFedExternalDomainFederation/domains
+Content-Type: application/json
+Content-length: 60
+
+{
+ "@odata.type": "microsoft.graph.externalDomainName",
+ "id": "contososuites.com"
+}
+```
+
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.externalDomainName"
+}
+-->
+
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.type": "#microsoft.graph.externalDomainName",
+ "id": "contososuites.com"
+}
+```
v1.0 Samlorwsfedexternaldomainfederation Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-post.md
+
+ Title: "Create samlOrWsFedExternalDomainFederation"
+description: "Create a new samlOrWsFedExternalDomainFederation object."
+
+localization_priority: medium
++
+# Create samlOrWsFedExternalDomainFederation
+Namespace: microsoft.graph
++
+Create a new [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account)|Domain.Read.All, Domain.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application|Domain.Read.All, Domain.ReadWrite.All|
+
+The work or school account needs to belong to one of the following roles:
+
+* Global Administrator
+* External Identity Provider Administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+POST /directory/federationConfigurations
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object.
+
+The following table shows the properties that are required when you create the [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md).
+
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The display name of the SAML/WS-Fed based identity provider. Inherited from [identityProviderBase](../resources/identityproviderbase.md).|
+|issuerUri|String|Issuer URI of the federation server. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|metadataExchangeUri|String|URI of the metadata exchange endpoint used for authentication from rich client applications. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|passiveSignInUri|String|URI that web-based clients are directed to when signing in to Azure AD services. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|preferredAuthenticationProtocol|String|Preferred authentication protocol. Supported values include `saml` or `wsfed`. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br/><br/> This property is used in the following scenarios: <ul><li> if a rollover is required outside of the autorollover update <li>a new federation service is being set up <li> if the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated. </ul> <br/><br/> Azure AD updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Azure AD monitors the metadata daily and will update the federation settings for the domain when a new certificate is available.|
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "create_samlorwsfedexternaldomainfederation_from_"
+}
+-->
+
+``` http
+POST https://graph.microsoft.com/beta/directory/federationConfigurations
+Content-Type: application/json
+Content-length: 283
+
+{
+ "@odata.type": "microsoft.graph.samlOrWsFedExternalDomainFederation",
+ "issuerUri": "https://contoso.com/issuerUri",
+ "displayName": "contoso display name",
+ "metadataExchangeUri": "https://contoso.com/metadataExchangeUri",
+ "passiveSignInUri": "https://contoso.com/signin",
+ "preferredAuthenticationProtocol": "wsFed",
+ "domains": [
+ {
+ "@odata.type": "microsoft.graph.externalDomainName",
+ "id": "contoso.com"
+ }
+ ],
+ "signingCertificate": "MIIDADCCAeigAwIBAgIQEX41y8r6"
+}
+```
+
+### Response
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.identityProviderBase"
+}
+-->
+
+``` http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "id": "3c41f317-9af3-4266-8ccf-26283ceec888",
+ "displayName": "contoso display name"
+}
+```
v1.0 Samlorwsfedexternaldomainfederation Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/samlorwsfedexternaldomainfederation-update.md
+
+ Title: "Update samlOrWsFedExternalDomainFederation"
+description: "Update the properties of a samlOrWsFedExternalDomainFederation object."
+
+localization_priority: medium
++
+# Update samlOrWsFedExternalDomainFederation
+Namespace: microsoft.graph
++
+Update the properties of a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account)|Domain.ReadWrite.All|
+|Delegated (personal Microsoft account)| Not supported.|
+|Application|Domain.ReadWrite.All|
+
+The work or school account needs to belong to one of the following [Azure Active Directory (Azure AD) roles](/azure/active-directory/roles/permissions-reference):
+
+* Global Administrator
+* External Identity Provider Administrator
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+``` http
+PATCH directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/{samlOrWsFedExternalDomainFederation ID}
+```
+
+## Request headers
+
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, provide a JSON object with one or more properties that need to be updated for a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object in Azure AD tenant.
+
+The following table shows the properties that you may update for a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object.
+
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The display name of the SAML/WS-Fed based identity provider. Inherited from [identityProviderBase](../resources/identityproviderbase.md).|
+|issuerUri|String|Issuer URI of the federation server. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|metadataExchangeUri|String|URI of the metadata exchange endpoint used for authentication from rich client applications. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|passiveSignInUri|String|URI that web-based clients are directed to when signing in to Azure AD services. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|preferredAuthenticationProtocol|String|Preferred authentication protocol. Supported values include `saml` or `wsfed`. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br/><br/> This property is used in the following scenarios: <ul><li> if a rollover is required outside of the autorollover update <li>a new federation service is being set up <li> if the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated. </ul> <br/><br/> Azure AD updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Azure AD monitors the metadata daily and will update the federation settings for the domain when a new certificate is available.|
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object in the response body.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "update_samlorwsfedexternaldomainfederation"
+}
+-->
+
+``` http
+PATCH https://graph.microsoft.com/beta/directory/federationConfigurations/graph.samlOrWsFedExternalDomainFederation/d5a56845-6845-d5a5-4568-a5d54568a5d5
+Content-Type: application/json
+
+{
+ "displayName": "Contoso name change",
+ "issuerUri": "http://contoso-test.com/adfs/services/trust",
+ "metadataExchangeUri": null,
+ "signingCertificate": "M66C6DCCAdCgAwIBAgIQQ6vYJIVKQ",
+ "passiveSignInUri": "https://contoso-test.com/adfs/ls/",
+ "preferredAuthenticationProtocol": "wsFed"
+}
++
+```
+
+### Response
+
+The following is an example of the response.
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.samlOrWsFedExternalDomainFederation"
+}
+-->
+
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "id": "d5a56845-6845-d5a5-4568-a5d54568a5d5",
+ "displayName": "Contoso name change",
+ "issuerUri": "http://contoso-test.com/adfs/services/trust",
+ "metadataExchangeUri": null,
+ "signingCertificate": "M66C6DCCAdCgAwIBAgIQQ6vYJIVKQ",
+ "passiveSignInUri": "https://contoso-test.com/adfs/ls/",
+ "preferredAuthenticationProtocol": "wsFed",
+ "domains": [
+ {
+ "id": "contoso.com"
+ }
+ ]
+}
+```
v1.0 Serviceprincipal Checkmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-checkmembergroups.md
Title: "servicePrincipal: checkMemberGroups" description: "Check for membership in the specified list of groups. Returns from the list those groups of which the service principal has a direct or transitive membership."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
Content-length: 44
### Response
-Here is an example of the response.
+Here is an example of the response.
>Note: The response object shown here might be shortened for readability. <!-- { "blockType": "response",
v1.0 Serviceprincipal Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-get.md
Title: "Get servicePrincipal" description: "Retrieve the properties and relationships of serviceprincipal object."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "applications" doc_type: apiPageType
GET https://graph.microsoft.com/beta/servicePrincipals/{id}
### Response
-Here is an example of the response.
+Here is an example of the response.
>**Note:** The response object shown here might be shortened for readability.
v1.0 Serviceprincipal Getmembergroups https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-getmembergroups.md
Title: "servicePrincipal: getMemberGroups" description: "Get the list of groups that this service principal is a member of. The check is transitive."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
Content-length: 33
### Response
-Here is an example of the response.
+Here is an example of the response.
>Note: The response object shown here might be shortened for readability. <!-- { "blockType": "response",
v1.0 Serviceprincipal Getmemberobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-getmemberobjects.md
Title: "servicePrincipal: getMemberObjects" description: "Get the list of groups and directory roles that this service principal is a member of. This check is transitive."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
Content-length: 33
### Response
-Here is an example of the response.
+Here is an example of the response.
>Note: The response object shown here might be shortened for readability. <!-- { "blockType": "response",
v1.0 Serviceprincipal List Approleassignedto https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-list-approleassignedto.md
Title: "List appRoleAssignments granted for a service principal" description: "Retrieve a list of app role assignments granted for a service principal."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
GET https://graph.microsoft.com/beta/servicePrincipals/8e881353-1735-45af-af21-e
### Response
-Here is an example of the response.
+Here is an example of the response.
> **Note:** The response object shown here might be shortened for readability.
v1.0 Serviceprincipal List Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-list-approleassignments.md
Title: "List appRoleAssignments granted to a service principal" description: "Retrieve the list of app role assignments granted to a service principal."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
GET https://graph.microsoft.com/beta/servicePrincipals/8e881353-1735-45af-af21-e
### Response
-Here is an example of the response.
+Here is an example of the response.
> **Note:** The response object shown here might be shortened for readability.
v1.0 Serviceprincipal List Memberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-list-memberof.md
Title: "List servicePrincipal memberOf" description: "Get the groups and directory roles that this service principal is a direct member of. This operation is not transitive."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
GET https://graph.microsoft.com/beta/servicePrincipals/{id}/memberOf
#### Response
-The following is an example of the response.
+The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
The following is an example of the request.
"name": "get_video_count" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/servicePrincipals/{id}/memberOf/microsoft.graph.group?$count=true&$orderby=displayName&$search=ΓÇ¥displayName:Video"
+GET https://graph.microsoft.com/beta/servicePrincipals/{id}/memberOf/microsoft.graph.group?$count=true&$orderby=displayName&$search=ΓÇ¥displayName:Video"
ConsistencyLevel: eventual ```
v1.0 Serviceprincipal List Oauth2permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-list-oauth2permissiongrants.md
Title: "List oauth2PermissionGrants" description: "Retrieve a list of oAuth2PermissionGrant objects, representing delegated permission grants."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
GET https://graph.microsoft.com/beta/servicePrincipals/{id}/oauth2PermissionGran
### Response
-Here is an example of the response.
+Here is an example of the response.
> **Note:** The response object shown here might be shortened for readability.
v1.0 Serviceprincipal List Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-list-owners.md
Title: "servicePrincipals: List owners" description: "Retrieve a list of owners of the servicePrincipal."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
GET https://graph.microsoft.com/beta/servicePrincipals/{id}/owners
### Response
-Here is an example of the response.
+Here is an example of the response.
> Note: The response object shown here might be shortened for readability. <!-- {
v1.0 Serviceprincipal List Transitivememberof https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-list-transitivememberof.md
Title: "List servicePrincipal transitive memberOf" description: "Get the groups and directory roles that this service principal is a member of."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
GET https://graph.microsoft.com/beta/servicePrincipals/{id}/transitiveMemberOf
#### Response
-The following is an example of the response.
+The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Serviceprincipal List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-list.md
Title: "List servicePrincipals" description: "Retrieve a list of servicePrincipal objects."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
v1.0 Serviceprincipal Post Approleassignedto https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-post-approleassignedto.md
Title: "Grant an appRoleAssignment for a service principal" description: "Grant an app role assignment for a service principal."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
In this example, `{id}` and `{resourceId-value}` would both be the `id` of the r
### Response
-Here is an example of the response.
+Here is an example of the response.
> **Note:** The response object shown here might be shortened for readability.
v1.0 Serviceprincipal Post Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-post-approleassignments.md
Title: "Grant an appRoleAssignment to a service principal" description: "Grant an app role assignment to a service principal."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
In this example, note that the value used as the service principal **id** in the
### Response
-Here is an example of the response.
+Here is an example of the response.
> **Note:** The response object shown here might be shortened for readability.
v1.0 Serviceprincipal Post Owners https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-post-owners.md
Title: "servicePrincipal: Add owner" description: "Add an owner for the service principal."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
v1.0 Serviceprincipal Post Serviceprincipals https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-post-serviceprincipals.md
Title: "Create serviceprincipal" description: "Create a new serviceprincipal object."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
Content-type: application/json
### Response
-Here is an example of the response.
+Here is an example of the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Serviceprincipal Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-update.md
Title: "Update serviceprincipal" description: "Update the properties of serviceprincipal object."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "applications"
v1.0 Team Delete Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-delete-members.md
Title: "Remove member from team" description: "Remove a conversationMember from a team."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Team Get Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-get-members.md
Title: "Get member of team" description: "Get member of team."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
GET https://graph.microsoft.com/beta/teams/ece6f0a1-7ca4-498b-be79-edf6c8fc4d82/
Here is an example of the response.
->**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response", "truncated": true,
v1.0 Team Get Photo https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-get-photo.md
Title: "Get team photo" description: "Get the photo (picture) for a team."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Team Get Primarychannel https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-get-primarychannel.md
Title: "Get primaryChannel" description: "Retrieve the navigation property of a team that allows access to its default General channel."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
GET https://graph.microsoft.com/beta/teams/{id}/primaryChannel
### Response
-The following is an example of the response.
+The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- {
v1.0 Team Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-get.md
Title: "Get team" description: "Retrieve the properties and relationships of the specified team."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
GET https://graph.microsoft.com/beta/teams/893075dd-2487-4122-925f-022c42e20265
#### Response
-The following is an example of the response.
+The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- {
Content-length: 401
"allowDeleteChannels": true, "allowAddRemoveApps": true, "allowCreateUpdateRemoveTabs": true,
- "allowCreateUpdateRemoveConnectors": true
+ "allowCreateUpdateRemoveConnectors": true
}, "guestSettings": { "allowCreateUpdateChannels": true,
- "allowDeleteChannels": true
+ "allowDeleteChannels": true
}, "messagingSettings": { "allowUserEditMessages": true, "allowUserDeleteMessages": true, "allowOwnerDeleteMessages": true, "allowTeamMentions": true,
- "allowChannelMentions": true
+ "allowChannelMentions": true
}, "funSettings": { "allowGiphy": true,
v1.0 Team List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-list-members.md
Title: "List members of team" description: "Get the conversationMembers of a team."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Team List Permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-list-permissiongrants.md
Title: "List permissionGrants of a team" description: "Retrieve permissionGrants of a team."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Team Post Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-post-members.md
Title: "Add member to team" description: "Add a new member to a team."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
v1.0 Team Post https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-post.md
Title: "Create team" description: "Create a new team."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
Content-Location: /teams('dbd8de4f-5d47-48da-87f1-594bed003375')
#### Error response
-If the request is unsuccessful, this method returns a `400 Bad Request` response code.
+If the request is unsuccessful, this method returns a `400 Bad Request` response code.
```http 400 Bad Request
v1.0 Team Put Teams https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/team-put-teams.md
Title: "Create team from group" description: "Create a new team from a group."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
Create a new [team](../resources/team.md) from a [group](../resources/group.md).
In order to create a team, the group must have a least one owner.
-If the group was created less than 15 minutes ago, it's possible for the Create team call to fail with a 404 error code due to replication delays.
+If the group was created less than 15 minutes ago, it's possible for the Create team call to fail with a 404 error code due to replication delays.
The recommended pattern is to retry the Create team call three times, with a 10 second delay between calls. ## Permissions
The following is an example of the request.
PUT https://graph.microsoft.com/beta/groups/{id}/team Content-type: application/json
-{
+{
"memberSettings": { "allowCreateUpdateChannels": true },
Content-type: application/json
#### Response
-The following is an example of the response.
+The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- {
Content-length: 401
"allowDeleteChannels": true, "allowAddRemoveApps": true, "allowCreateUpdateRemoveTabs": true,
- "allowCreateUpdateRemoveConnectors": true
+ "allowCreateUpdateRemoveConnectors": true
}, "guestSettings": { "allowCreateUpdateChannels": true,
- "allowDeleteChannels": true
+ "allowDeleteChannels": true
}, "messagingSettings": { "allowUserEditMessages": true, "allowUserDeleteMessages": true, "allowOwnerDeleteMessages": true, "allowTeamMentions": true,
- "allowChannelMentions": true
+ "allowChannelMentions": true
}, "funSettings": { "allowGiphy": true,
v1.0 User Findroomlists https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-findroomlists.md
Title: "user: findRoomLists" description: "Get the room lists defined in a tenant."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "outlook" doc_type: apiPageType
GET https://graph.microsoft.com/beta/me/findRoomLists
##### Response
-Here is an example of the response.
+Here is an example of the response.
Note: The response object shown here might be shortened for readability. <!-- {
v1.0 User Findrooms https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-findrooms.md
Title: "user: findRooms" description: "Get all the meeting rooms in the user's tenant or in a specific room list. "
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "outlook" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get the [emailAddress](../resources/emailaddress.md) objects that represent all the meeting rooms in the user's tenant or in a specific room list.
+Get the [emailAddress](../resources/emailaddress.md) objects that represent all the meeting rooms in the user's tenant or in a specific room list.
-Tenants can organize meeting rooms into room lists. In this API, each meeting room and room list is represented by an [emailAddress](../resources/emailaddress.md) instance.
-You can [get all the room lists](user-findroomlists.md) in the tenant, get all the rooms in the tenant, or get all the rooms in a specific room list. You can get
+Tenants can organize meeting rooms into room lists. In this API, each meeting room and room list is represented by an [emailAddress](../resources/emailaddress.md) instance.
+You can [get all the room lists](user-findroomlists.md) in the tenant, get all the rooms in the tenant, or get all the rooms in a specific room list. You can get
up to the first 100 rooms in the tenant. ## Permissions
GET https://graph.microsoft.com/beta/me/findRooms
##### Response 1
-Here is an example of the response.
+Here is an example of the response.
Note: The response object shown here might be shortened for readability. <!-- {
The second example gets the [emailAddress](../resources/emailaddress.md) objects
"name": "user_get_rooms_from_specific_list" }--> ```msgraph-interactive
-GET https://graph.microsoft.com/beta/me/findRooms(RoomList='Building2Rooms@contoso.onmicrosoft.com')
+GET https://graph.microsoft.com/beta/me/findRooms(RoomList='Building2Rooms@contoso.onmicrosoft.com')
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/user-get-rooms-from-specific-list-csharp-snippets.md)]
GET https://graph.microsoft.com/beta/me/findRooms(RoomList='Building2Rooms@conto
##### Response 2
-Here is an example of the response.
+Here is an example of the response.
Note: The response object shown here might be shortened for readability. <!-- {
v1.0 User Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-get.md
Title: "Get a user" description: "Retrieve the properties and relationships of user object."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "users" doc_type: apiPageType
GET https://graph.microsoft.com/beta/me
##### Response
-Here is an example of the response. Note: The response object shown here might be shortened for readability.
+Here is an example of the response. Note: The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
v1.0 User List Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-approleassignments.md
Title: "List appRoleAssignments granted to a user" description: "Retrieve the list of app role assignments granted to a user."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "users"
GET https://graph.microsoft.com/beta/users/cdb555e3-b33e-4fd5-a427-17fadacbdfa7/
#### Response
-The following is an example of the response.
+The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability.
GET https://graph.microsoft.com/beta/users/cdb555e3-b33e-4fd5-a427-17fadacbdfa7/
#### Response
-The following is an example of the response.
+The following is an example of the response.
->**Note:** The response object shown here might be shortened for readability.
+>**Note:** The response object shown here might be shortened for readability.
<!-- { "blockType": "response",
v1.0 User List Events https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-events.md
Title: "List events" description: "Get a list of event objects from the user's default calendar or "
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "outlook" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-Get a list of [event](../resources/event.md) objects from the user's default calendar or
+Get a list of [event](../resources/event.md) objects from the user's default calendar or
from a specified calendar. The list contains single instance meetings and series masters.
-To get expanded event instances, you can [get the calendar view](calendar-list-calendarview.md), or
+To get expanded event instances, you can [get the calendar view](calendar-list-calendarview.md), or
[get the instances of an event](event-list-instances.md). There are two scenarios where an app can get events in another user's calendar:
There are two scenarios where an app can get events in another user's calendar:
### Support various time zones
-For all GET operations that return events, you can use the `Prefer: outlook.timezone` header to specify the time zone for the event start and end times in the response.
+For all GET operations that return events, you can use the `Prefer: outlook.timezone` header to specify the time zone for the event start and end times in the response.
For example, the following `Prefer: outlook.timezone` header sets the start and end times in the response to Eastern Standard Time. ```http Prefer: outlook.timezone="Eastern Standard Time" ```
-If the event was created in a different time zone, the start and end times will be adjusted to the time zone specified in that `Prefer` header.
-See this [list](../resources/datetimetimezone.md) for the supported time zone names. If the `Prefer: outlook.timezone` header is not specified, the start and end
+If the event was created in a different time zone, the start and end times will be adjusted to the time zone specified in that `Prefer` header.
+See this [list](../resources/datetimetimezone.md) for the supported time zone names. If the `Prefer: outlook.timezone` header is not specified, the start and end
times are returned in UTC.
-You can use the **OriginalStartTimeZone** and **OriginalEndTimeZone** properties on the **event** resource to
+You can use the **OriginalStartTimeZone** and **OriginalEndTimeZone** properties on the **event** resource to
find out the time zone used when the event was created. ## Permissions
If successful, this method returns a `200 OK` response code and collection of [e
##### Request 1 The first example gets all the user's events. It specifies the following: -- A `Prefer: outlook.timezone` header to get date time values returned in Pacific Standard Time.
+- A `Prefer: outlook.timezone` header to get date time values returned in Pacific Standard Time.
- A `$select` query parameter to return specific properties. Without a `$select` parameter, all of the event properties will be returned.
-The request does not specify any `Prefer: outlook.body-content-type` header to indicate a specific format for the returned event body.
+The request does not specify any `Prefer: outlook.body-content-type` header to indicate a specific format for the returned event body.
# [HTTP](#tab/http)
The request also uses a `$select` query parameter to return specific properties.
}--> ```msgraph-interactive GET https://graph.microsoft.com/beta/me/events?$select=subject,body,bodyPreview
-Prefer: outlook.body-content-type="text"
+Prefer: outlook.body-content-type="text"
``` # [C#](#tab/csharp) [!INCLUDE [sample-code](../includes/snippets/csharp/get-events-in-text-csharp-snippets.md)]
Prefer: outlook.body-content-type="text"
##### Response 2
-Here is an example of the response. The **body** property is returned in text format.
+Here is an example of the response. The **body** property is returned in text format.
<!-- { "blockType": "response",
v1.0 User List Joinedteams https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-joinedteams.md
Title: "List joinedTeams" description: "Get the teams in Microsoft Teams that the user is a direct member of."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: apiPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] Get the [teams](../resources/team.md) in Microsoft Teams that the user is a direct member of.
-
+ ## Permissions One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
v1.0 User List Oauth2permissiongrants https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-oauth2permissiongrants.md
Title: "List oauth2PermissionGrants" description: "Retrieve a list of oAuth2PermissionGrant objects, representing delegated permission grants."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "identity-and-sign-in"
GET https://graph.microsoft.com/beta/users/7d54cb02-aaa3-4016-9f9c-a4b49422dd9b/
### Response
-Here is an example of the response.
+Here is an example of the response.
> **Note:** The response object shown here might be shortened for readability.
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list.md
Title: "List users" description: "Retrieve a list of user objects."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "users" doc_type: apiPageType
GET https://graph.microsoft.com/beta/users
#### Response
-The following is an example of the response.
+The following is an example of the response.
>**Note:** The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
"mail":"'contoso1@gmail.com", "mailNickname":"contoso1_gmail.com#EXT#", "otherMails":["contoso1@gmail.com"],
- "proxyAddresses":["SMTP:contoso1@gmail.com"],
+ "proxyAddresses":["SMTP:contoso1@gmail.com"],
"userPrincipalName":"contoso1_gmail.com#EXT#@microsoft.onmicrosoft.com" } ]
GET https://graph.microsoft.com/beta/users?$select=displayName,id&$filter=identi
#### Response
-The following is an example of the response.
+The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
GET https://graph.microsoft.com/beta/users?$select=displayName,userPrincipalName
#### Response
-The following is an example of the response.
+The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
GET https://graph.microsoft.com/beta/users?$filter=startswith(displayName,'Eric'
#### Response
-The following is an example of the response.
+The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
GET https://graph.microsoft.com/beta/users?filter=signInActivity/lastSignInDateT
#### Response
-The following is an example of the response.
+The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
ConsistencyLevel: eventual
#### Response
-The following is an example of the response.
+The following is an example of the response.
> **Note:** The response object shown here might be shortened for readability. <!-- {
Content-type: application/json
"displayName":"contoso1", "mail":"'contoso1@gmail.com", "mailNickname":"contoso1_gmail.com#EXT#",
- "proxyAddresses":["SMTP:contoso1@gmail.com"],
+ "proxyAddresses":["SMTP:contoso1@gmail.com"],
"userPrincipalName":"contoso1_gmail.com#EXT#@microsoft.onmicrosoft.com" } ]
v1.0 User Post Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-post-approleassignments.md
Title: "Grant an appRoleAssignment to a user" description: "Grant an app role assignment to a user."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: apiPageType ms.prod: "users"
In this example, note that the value used as the user **id** in the request URL
### Response
-Here is an example of the response.
+Here is an example of the response.
> **Note:** The response object shown here might be shortened for readability.
v1.0 Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/overview.md
Title: "Microsoft Graph beta endpoint reference" description: "The reference content in this section documents the Microsoft Graph beta endpoint. The beta endpoint includes APIs that are currently in preview and are not yet generally available. We invite you to try these APIs and provide your feedback via the following channels:"
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: conceptualPageType ms.prod: "non-product-specific"
The reference content in this section documents the Microsoft Graph beta endpoin
- [GitHub](https://github.com/OfficeDev/microsoft-graph-docs/issues) - For feedback on the Preview APIs. Tag with `beta`. - [StackOverflow](https://stackoverflow.com/questions/tagged/microsoft-graph-api) - For questions or help with your code. Tag with `microsoft-graph-api`.
-> **Note:** The APIs in the beta endpoint are subject to change. We don't recommend that you use them in your production apps.
+> **Note:** The APIs in the beta endpoint are subject to change. We don't recommend that you use them in your production apps.
## Call the beta endpoint
v1.0 Aaduserconversationmember https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/aaduserconversationmember.md
Title: "aadUserConversationMember resource type" description: "Represents an Azure Active Directory user in a chat or channel."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: resourcePageType
Represents an Azure Active Directory user in a [team](team.md) or a [channel](ch
|[Update channel member's role](../api/channel-update-members.md) | [conversationMember](conversationmember.md) | Update the properties of a member of the channel. Only supported for channel with membershipType of `private`.| |[Remove channel member](../api/channel-delete-members.md) | None | Delete a member from a channel. Only supported for `channelType` of `private`.| |[List chat members](../api/chat-list-members.md) | [conversationMember](conversationmember.md) collection | Get the list of all members in a chat.|
-|[Add chat member](../api/chat-post-members.md) | Location header | Add a member to a chat.|
+|[Add chat member](../api/chat-post-members.md) | Location header | Add a member to a chat.|
|[Get chat member](../api/chat-get-members.md) | [conversationMember](conversationmember.md) | Get a member in a chat.|
-|[Remove chat member](../api/chat-delete-members.md) | None | Remove a member from a chat.|
+|[Remove chat member](../api/chat-delete-members.md) | None | Remove a member from a chat.|
## Properties
v1.0 Applemanagedidentityprovider https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/applemanagedidentityprovider.md
Title: "appleManagedIdentityProvider resource type" description: "Represents apple identity provider in an Azure AD B2C tenant."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "identity-and-sign-in"
v1.0 Application https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/application.md
Title: "application resource type" description: "Represents an application."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "applications" doc_type: resourcePageType
v1.0 Approleassignment https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/approleassignment.md
Title: "appRoleAssignment resource type" description: "Used to record when a user, group, or service principal is assigned to an app role on an application's service principal. You can create, read and delete app role assignments."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "applications"
v1.0 Authenticationflowspolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/authenticationflowspolicy.md
Title: "authenticationFlowsPolicy resource type" description: "Represents the policy configuration of self-service sign-up experience at a tenant level that lets external users request to sign up for approval. "
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "identity-and-sign-in" doc_type: resourcePageType
v1.0 Azure Ad Auditlog Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/azure-ad-auditlog-overview.md
Title: "Activity reports API overview" description: "Use the activity reports API in Microsoft Graph to access the reports that Azure Active Directory creates to help you track user activity in a tenant."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: conceptualPageType ms.prod: "identity-and-access-reports"
The availability of these activity reports is governed by the Azure AD data rete
Azure AD provides three types of activity reports: -- Directory audits
+- Directory audits
- Sign-ins - Provisioning
To learn more, see [Azure AD pricing](https://azure.microsoft.com/pricing/detail
## Next steps -- [Register your app](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to satisfy report prerequisites. -- To learn how to retrieve audit logs while authenticated using certificates, see [Tutorial: Get data using the Azure Active Directory reporting API with certificates](/azure/active-directory/reports-monitoring/tutorial-access-api-with-certificates).
+- [Register your app](/azure/active-directory/active-directory-reporting-api-prerequisites-azure-portal) to satisfy report prerequisites.
+- To learn how to retrieve audit logs while authenticated using certificates, see [Tutorial: Get data using the Azure Active Directory reporting API with certificates](/azure/active-directory/reports-monitoring/tutorial-access-api-with-certificates).
- Review the [directoryAudit](directoryaudit.md) resource and actions.-- Review the [signIn](signin.md) resource and actions.
+- Review the [signIn](signin.md) resource and actions.
- Review the [provisioningObjectSummary](provisioningobjectsummary.md) resource.
v1.0 Azure Ad Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/azure-ad-overview.md
Title: "Working with Azure Active Directory resources in Microsoft Graph" description: "Microsoft Graph for Azure Active Directory (Azure AD) provides REST APIs to help manage your organization, resources, and assets."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: conceptualPageType ms.prod: "identity-and-access"
v1.0 B2cauthenticationmethodspolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/b2cauthenticationmethodspolicy.md
Title: "b2cAuthenticationMethodsPolicy resource type" description: "Represents a local account authentication method registered to a user configured in an Azure Active Directory (Azure AD) B2C tenant."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "identity-and-sign-in" doc_type: "resourcePageType"
v1.0 B2cidentityuserflow https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/b2cidentityuserflow.md
Title: "b2cIdentityUserFlow resource type" description: "Represents a user flow within an Azure Active Directory B2C tenant."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "identity-and-sign-in"
v1.0 B2xidentityuserflow https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/b2xidentityuserflow.md
Title: "b2xIdentityUserFlow resource type" description: "Represents a self-service sign up user flow within an Azure Active Directory tenant."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "identity-and-sign-in"
v1.0 Booking Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/booking-api-overview.md
Title: "Use the Microsoft Bookings API in Microsoft Graph" description: "Microsoft Bookings lets enterprise organization and small business owners manage customer bookings and information with minimal setup."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "bookings" doc_type: conceptualPageType
doc_type: conceptualPageType
# Use the Microsoft Bookings API in Microsoft Graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-
+ Microsoft Bookings lets enterprise organization and small business owners manage customer bookings and information with minimal setup. A business owner can create one or more businesses, with each business offering a set of services. The owner can set up staff members, and specify the services that each staff member performs. A customer can book an appointment for a specific service in that business in an online or mobile app. Bookings ensures that the appointment time is kept up-to-date for the business, staff members, and customers involved. Programmatically, a [bookingBusiness](bookingbusiness.md) in the Bookings API involves the following objects:
-
+ - One or more [bookingStaffMember](bookingstaffmember.md) objects - One or more [bookingService](bookingservice.md) objects - A set of [bookingAppointment](bookingappointment.md) instances
GET https://graph.microsoft.com/beta/bookingBusinesses
Authorization: Bearer {access token} ```
-## Common use cases
+## Common use cases
The following table lists the common operations for a business in the Bookings API.
v1.0 Builtinidentityprovider https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/builtinidentityprovider.md
Title: "builtInIdentityProvider resource type" description: "Represents built-in identity providers in an Azure Active Directory tenant."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "identity-and-sign-in"
v1.0 Calendar https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/calendar.md
Title: "calendar resource type" description: "A calendar which is a container for events. It can be a calendar for a user, or the default calendar of a Microsoft 365 group."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "outlook" doc_type: resourcePageType
v1.0 Call https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/call.md
Title: "call resource type" description: "The **call** resource is created when there is an incoming call for the application or the application creates a new outgoing call via a `POST` on `app/calls`."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "cloud-communications" doc_type: resourcePageType
v1.0 Callrecords Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/callrecords-api-overview.md
description: "The Microsoft Graph call records API allows you to retrieve usage
doc_type: conceptualPageType ms.prod: cloud-communications
-localization_priority: Priority
+ms.localizationpriority: high
# Working with the call records API in Microsoft Graph
v1.0 Channel https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/channel.md
Title: "channel resource type" description: "A channel is a collection of chatMessages within a team. "
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: resourcePageType
v1.0 Claimsmapping https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/claimsmapping.md
Title: "claimsMapping resource type" description: "Map the claims from a token to the claims that Azure Active Directory B2C recognizes and uses."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "identity-and-sign-in" doc_type: resourcePageType
v1.0 Communications Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/communications-api-overview.md
description: "The Microsoft Graph communications API adds a new dimension to how
doc_type: conceptualPageType ms.prod: cloud-communications
-localization_priority: Priority
+ms.localizationpriority: high
# Working with the communications API in Microsoft Graph
v1.0 Complianceapioverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/complianceapioverview.md
Title: "Use the Microsoft Graph compliance API" description: "The Microsoft Graph compliance API provides a unified interface and schema to integrate with compliance solutions from Microsoft and ecosystem partners. This can help customers streamline their compliance operations to better manage and monitor their data, protect information, minimize insider risk, perform legal and internal investigations, and comply with legal or regulatory standards."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "compliance" doc_type: conceptualPageType
v1.0 Directory https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/directory.md
Title: "directory resource type (deleted items)" description: ". Deleted items will remain available to restore for up to 30 days. After 30 days, the items are permanently deleted."
-localization_priority: Normal
+ms.localizationpriority: medium
ms.prod: "directory-management" doc_type: resourcePageType
Represents a deleted item in the directory. When an item is deleted, it is added
Currently, deleted items functionality is only supported for the [application](application.md), [group](group.md) and [user](user.md) resources.
+Inherits from [entity](entity.md).
+ ## Methods | Method | Return Type | Description |
Currently, deleted items functionality is only supported for the [application](a
|[List deleted items](../api/directory-deleteditems-list.md) |[directoryObject](directoryobject.md) collection| Gets a list of recently deleted items. | |[Permanently delete an item](../api/directory-deleteditems-delete.md) | None | Permanently deletes an item. | |[List deleted items owned by a user](../api/directory-deleteditems-user-owned.md) | [directoryObject](directoryobject.md) collection | Lists directory items owned by a user. |
-|[List featureRolloutPolicies](../api/list-featurerolloutpolicies.md) | [featureRolloutPolicy](featurerolloutpolicy.md) collection | Retrieve a list of featureRolloutPolicy objects. |
-|[Create featureRolloutPolicy](../api/post-featurerolloutpolicies.md) | [featureRolloutPolicy](featurerolloutpolicy.md) | Create a new featureRolloutPolicy object. |
-| [Get featureRolloutPolicy](../api/featurerolloutpolicy-get.md) | [featureRolloutPolicy](featurerolloutpolicy.md) | Retrieve the properties and relationships of featurerolloutpolicy object. |
-| [Update featureRolloutPolicy](../api/featurerolloutpolicy-update.md) | [featureRolloutPolicy](featurerolloutpolicy.md) | Update the properties of featurerolloutpolicy object. |
-| [Delete featureRolloutPolicy](../api/featurerolloutpolicy-delete.md) | None | Delete a featureRolloutPolicy object. |
## Properties+ | Property | Type |Description| |:|:--|:-|
-|id|String| A unique identifier for the object; for example, 12345678-9abc-def0-1234-56789abcde. Key. Not nullable. Read-only.|
+|id|String| A unique identifier for the object; for example, `12345678-9abc-def0-1234-56789abcde`. Key. Not nullable. Read-only. Inherited from [entity](entity.md).|
## Relationships+ | Relationship | Type |Description| |:|:--|:-|
+|administrativeUnits|[administrativeUnit](administrativeunit.md) collection| Conceptual container for user and group directory objects.|
|deleteditems|[directoryObject](directoryobject.md) collection| Recently deleted items. Read-only. Nullable.| |featureRolloutPolicies|[featureRolloutPolicy](featurerolloutpolicy.md) collection| Nullable.|
+|federationConfigurations|[identityProviderBase](../resources/identityproviderbase.md) collection|Configure domain federation with organizations whose identity provider (IdP) supports either the SAML or WS-Fed protocol.|
## JSON representation
-Here is a JSON representation of the resource.
+
+The following is a JSON representation of the resource.
<!-- { "blockType": "resource",
v1.0 Directoryobject https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/directoryobject.md
Title: "directoryObject resource type" description: "Represents an Azure Active Directory object. The **directoryObject** type is the base type for many other directory entity types."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "directory-management" doc_type: resourcePageType
v1.0 Drive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/drive.md
Title: drive resource type description: drive resource representing a user's onedrive or a document library in SharePoint
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "sharepoint" doc_type: resourcePageType
v1.0 Ediscovery Ediscoveryapioverview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/ediscovery-ediscoveryapioverview.md
Title: "Use the Microsoft Graph eDiscovery API" description: "The Microsoft 365 eDiscovery APIs provide functionality for organizations to automate repetitive tasks and integrate with their existing eDiscovery tools to build a repeatable workflows that might be required based on industry regulations. You can use the eDiscovery APIs to help with your legal needs."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "ediscovery" doc_type: conceptualPageType
v1.0 Event https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/event.md
Title: "event resource type" description: "An event in a calendar."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "outlook" doc_type: resourcePageType
Here is a JSON representation of the resource
"isDraft": false, "isOnlineMeeting": true, "isOrganizer": true,
- "isReminderOn": true,
+ "isReminderOn": true,
"lastModifiedDateTime": "String (timestamp)", "location": {"@odata.type": "microsoft.graph.location"}, "locations": [{"@odata.type": "microsoft.graph.location"}],
Here is a JSON representation of the resource
> * For Microsoft accounts: > `https://outlook.live.com/owa/?itemid={event-id}&exvsurl=1&path=/calendar/item` >
-> To open the event in a current version of Outlook on the web, convert the URL to one of the following formats, and use that URL to open the event:
+> To open the event in a current version of Outlook on the web, convert the URL to one of the following formats, and use that URL to open the event:
> > * For work or school accounts: > `https://outlook.office365.com/calendar/item/{event-id}`
v1.0 Externaldomainname https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/externaldomainname.md
+
+ Title: "externalDomainName resource type"
+description: "Domain name of the external organization an Azure Active Directory (Azure AD) tenant acting as the resource tenant is trying to set up federation with."
+
+localization_priority: Normal
++
+# externalDomainName resource type
+
+Namespace: microsoft.graph
++
+Represents the domain name of the external organization that an Azure Active Directory (Azure AD) tenant acting as the resource tenant is trying to set up federation with.
+
+Inherits from [entity](../resources/entity.md).
+
+## Methods
+None.
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|id|String|Domain name of the external organization that the Azure AD tenant is federating with. Inherited from [entity](../resources/entity.md).|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.externalDomainName",
+ "baseType": "microsoft.graph.entity",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.externalDomainName",
+ "id": "String (identifier)"
+}
+```
v1.0 Group https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/group.md
Title: "group resource type" description: "Represents an Azure Active Directory (Azure AD) group, which can be a Microsoft 365 group, a team in Microsoft Teams, or a security group."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "groups" doc_type: resourcePageType
v1.0 Groups Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/groups-overview.md
Title: "Working with groups in Microsoft Graph" description: "Groups are collections of users and other principals who share access to resources in Microsoft services or in your app. Microsoft Graph provides APIs that you can use to create and manage different types of groups and group functionality according to your scenario. All group-related operations in Microsoft Graph require administrator consent."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "groups" doc_type: conceptualPageType
v1.0 Identityprovider https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/identityprovider.md
Title: "identityProvider resource type" description: "Represents identity providers in an Azure Active Directory tenant and an Azure AD B2C tenant."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "identity-and-sign-in"
v1.0 Identityproviderbase https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/identityproviderbase.md
Title: "identityProviderBase resource type" description: "Represents identity providers in an Azure Active Directory tenant and an Azure AD B2C tenant."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "identity-and-sign-in"
v1.0 Identityuserflowattribute https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/identityuserflowattribute.md
Title: "identityUserFlowAttribute resource type" description: "Represents user flow attributes in an Azure Active Directory tenant and an Azure AD B2C tenant."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "identity-and-sign-in"
v1.0 Indexing Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/indexing-api-overview.md
Title: "Use the Microsoft Search API to index data" description: "Use Microsoft Graph to index custom items in the Microsoft Search service."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "search" doc_type: conceptualPageType
v1.0 Intune Graph Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/intune-graph-overview.md
Title: "Using the Intune Graph API - Microsoft Graph API" description: "Lists the Microsoft Graph API for Intune endpoints (REST) you can use to manage your tenant organization and its devices, apps, access, and resources."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "intune"
ms.prod: "intune"
The Microsoft Graph API for Intune enables programmatic access to Intune information for your tenant; the API performs the same Intune operations as those available through the **Azure Portal**.  
-For mobile device management (MDM) scenarios, the Microsoft Graph API for Intune supports standalone deployments; Intune [hybrid deployments](/sccm/mdm/understand/choose-between-standalone-intune-and-hybrid-mobile-device-management) are not supported.
+For mobile device management (MDM) scenarios, the Microsoft Graph API for Intune supports standalone deployments; Intune [hybrid deployments](/sccm/mdm/understand/choose-between-standalone-intune-and-hybrid-mobile-device-management) are not supported.
-All Microsoft Graph beta APIs for Intune are tested and validated by the Intune team before they're deployed. For the latest API changes, see the [changelog](/graph/changelog).
+All Microsoft Graph beta APIs for Intune are tested and validated by the Intune team before they're deployed. For the latest API changes, see the [changelog](/graph/changelog).
## Using the Microsoft Graph API for Intune
Find out about the [latest new features and updates](/graph/whats-new-overview)
## Next Steps -- Learn [how to use Azure AD](/intune/intune-graph-apis) to access the Microsoft Graph API for Intune.
+- Learn [how to use Azure AD](/intune/intune-graph-apis) to access the Microsoft Graph API for Intune.
- Explore the [PowerShell Intune samples](https://github.com/microsoftgraph/powershell-intune-samples), which show how to use the Microsoft Graph API for Intune in context of working examples.
v1.0 Iteminsights https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/iteminsights.md
Title: "itemInsights resource type" description: "Relationships between a user and items such as OneDrive for Business documents, calculated using advanced analytics and machine learning techniques. You can, for example, identify OneDrive for Business documents trending around users."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "insights" doc_type: resourcePageType
v1.0 Mail Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/mail-api-overview.md
Title: "Use the Outlook mail REST API" description: "Microsoft Graph lets your app get authorized access to a user's Outlook mail data in a personal or organization account."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "outlook" doc_type: conceptualPageType
or the `me` shortcut alias for the signed-in user.
Email messages are represented by the [message](../resources/message.md) resource and organized in a [mailFolder](../resources/mailfolder.md). Messages and mail folders are identified by their **id** property, obtainable from `GET` operations.
->[!IMPORTANT]
+>[!IMPORTANT]
> In general, do not assume that **message** and **mailfolder** IDs are unique and always remain the same within a mailbox. They might change after certain actions such as copy or move. You can choose to use [immutable IDs](/graph/outlook-immutable-id) to retain the same ID as long as the message remains in the same mailbox, _with the exception of sending a draft message, and a few other scenarios_. See [lifetime of immutable IDs](/graph/outlook-immutable-id#lifetime-of-immutable-ids) for details.
v1.0 Message https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/message.md
Title: "message resource type" description: "A message in a mailbox folder."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "outlook" doc_type: resourcePageType
v1.0 Notifications Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/notifications-api-overview.md
Title: "Use the notifications REST API in Microsoft Graph" description: "You can use the notifications API in Microsoft Graph to send push notifications to a user. ."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "notifications" doc_type: conceptualPageType
You can use the notifications API in Microsoft Graph to send push notifications
1. User signs in to your application, which creates a subscription with the Microsoft Graph notification service. A specific user notification subscription ID or UNSID will be returned to the calling application. 2. The application sends this UNSID to your application service. 3. When ready to send a notification, your application service [authenticates with the Microsoft identity platform](/azure/active-directory/develop/v1-oauth2-client-creds-grant-flow) and posts a notification via the Microsoft Graph notification service, providing the auth token, target user's UNSID, and notification payload.
-4. The Microsoft Graph notification service fans-out notifications to all endpoints of the user with an active subscription.
+4. The Microsoft Graph notification service fans-out notifications to all endpoints of the user with an active subscription.
-This type of user-centric notification is represented by the [notification](../resources/projectrome-notification.md) resource and is stored within the Microsoft Graph notification service. It can then be accessed and managed by the client application via the [client-side SDK APIs](https://aka.ms/GNSDK). If you're new to the Microsoft Graph notification service, check out the [notification overview](/graph/notifications-concept-overview) section to learn more.
+This type of user-centric notification is represented by the [notification](../resources/projectrome-notification.md) resource and is stored within the Microsoft Graph notification service. It can then be accessed and managed by the client application via the [client-side SDK APIs](https://aka.ms/GNSDK). If you're new to the Microsoft Graph notification service, check out the [notification overview](/graph/notifications-concept-overview) section to learn more.
## What's new Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set. ## Next steps-- See the [notification resource](../resources/projectrome-notification.md) and create notifications to engage with your users.
+- See the [notification resource](../resources/projectrome-notification.md) and create notifications to engage with your users.
- Try the API in the [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer). - Get started with client integration by following the steps in the [integration overview](/graph/notifications-integration-e2e-overview) topic.
v1.0 Officegraphinsights https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/officegraphinsights.md
Title: "officeGraphInsights resource type" description: "Represents the base type for itemInsights. officeGraphInsights is for backward compatibility from earlier versions of the insights API. Use only itemInsights when accessing the insights API."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "insights" doc_type: resourcePageType
v1.0 Onedrive https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/onedrive.md
Title: "Working with files in Microsoft Graph" description: "You can use Microsoft Graph to create an app that connects with files across OneDrive, OneDrive for Business, and SharePoint document libraries. With Microsoft Graph, you can build a variety of experiences with files stored in Microsoft 365, from simply storing user documents to complex file sharing scenarios."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "sharepoint" doc_type: conceptualPageType
v1.0 Outlooktask https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/outlooktask.md
Title: "outlookTask resource type" description: "An Outlook item that can track a work item. "
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "outlook" doc_type: resourcePageType
v1.0 Permissiongrantconditionset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/permissiongrantconditionset.md
Title: "permissionGrantConditionSet resource type" description: "Specifies a matching rule with conditions under which an event is included or excluded from a permission grant policy."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "identity-and-sign-in"
v1.0 Permissiongrantpolicy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/permissiongrantpolicy.md
Title: "permissionGrantPolicy resource type" description: "Specifies the conditions under which consent can be authorized."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "identity-and-sign-in"
v1.0 Planner Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/planner-overview.md
Title: "Use the Planner REST API" description: "You can use the Planner API in Microsoft Graph to create tasks and assign them to users in a group in Microsoft 365."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "planner" doc_type: conceptualPageType
You can use the Planner API in Microsoft Graph to create tasks and assign them t
Before you get started with the Planner API, it will be helpful to understand how the main objects relate to each other as well as to Microsoft 365 groups. ## Plan containers
-In Planner, plans are always contained by another resource. The containing resource determines the authoization rules of the plan and all the tasks in it, as well as the lifecycle of the plan. For example, for plans contained by Microsoft 365 groups,
+In Planner, plans are always contained by another resource. The containing resource determines the authoization rules of the plan and all the tasks in it, as well as the lifecycle of the plan. For example, for plans contained by Microsoft 365 groups,
group members will be able to create, edit, resolve, and delete tasks in the plan, as well as changing some plan-level properties, such as the name of the plan or label names. Additionally, when the group is deleted, all the plans in the group are automatically deleted, or if a group is restored, all the plans will be automatically restored. The most common type of container is a Microsoft 365 group.
v1.0 Privilegedidentitymanagement Directory https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/privilegedidentitymanagement-directory.md
Title: "Privileged Identity Management - Azure AD" description: "APIs for Azure AD Privileged Identity Management to manage Azure Active Directory roles."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "governance" doc_type: conceptualPageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] > [!IMPORTANT]
-> The API to manage Azure AD roles is deprecated for most tenants except for a few that use an older version of Privileged Identity Management (PIM). For more information about PIM versions, see [Determine your version of PIM](https://docs.microsoft.com/azure/active-directory/privileged-identity-management/pim-how-to-activate-role?tabs=new#determine-your-version-of-pim). If you are using the new version and are recieving a **TenantEnabledInAadRoleMigration** error, you can wait until a new API is available for PIM functionality under the [unifiedRoleManagement](/graph/api/resources/unifiedroledefinition?view=graph-rest-beta) API for Azure AD roles, or you can use the [Azure Resource](/graph/api/resources/privilegedidentitymanagement-resources?view=graph-rest-beta) API for your Azure AD roles. To use the **Azure resource** API, replace `azureResources` with `aadRoles` for `provider_id` and use your tenant id for `resource_id`. We recommend that you wait for the new API. You will be able to continue using the **Azure resource** API after the new API is available. Any new features made available in the Azure portal will also be made exclusively available through the new API.
+> The API to manage Azure AD roles is deprecated for most tenants except for a few that use an older version of Privileged Identity Management (PIM). For more information about PIM versions, see [Determine your version of PIM](https://docs.microsoft.com/azure/active-directory/privileged-identity-management/pim-how-to-activate-role?tabs=new#determine-your-version-of-pim). If you are using the new version and are recieving a **TenantEnabledInAadRoleMigration** error, you can wait until a new API is available for PIM functionality under the [unifiedRoleManagement](/graph/api/resources/unifiedroledefinition?view=graph-rest-beta) API for Azure AD roles, or you can use the [Azure Resource](/graph/api/resources/privilegedidentitymanagement-resources?view=graph-rest-beta) API for your Azure AD roles. To use the **Azure resource** API, replace `azureResources` with `aadRoles` for `provider_id` and use your tenant id for `resource_id`. We recommend that you wait for the new API. You will be able to continue using the **Azure resource** API after the new API is available. Any new features made available in the Azure portal will also be made exclusively available through the new API.
The following methods are provided by PIM for Azure AD roles. The service is built on top of OData. To filter the results from a query, use the standard OData ``$filter`` expressions in the URIs.
v1.0 Privilegedidentitymanagement Resources https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/privilegedidentitymanagement-resources.md
Title: "Privileged Identity Management - Azure resources" description: "APIs for Azure AD Privileged Identity Management to manage Azure resources."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "governance" doc_type: conceptualPageType
v1.0 Privilegedidentitymanagement Root https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/privilegedidentitymanagement-root.md
Title: "Privileged Identity Management" description: "APIs for Azure AD Privileged Identity Management to manage Azure Active Directory roles and Azure resource roles."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: conceptualPageType ms.prod: "governance"
v1.0 Profile Example https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/profile-example.md
Title: "Use the Profile API in Microsoft Graph to retrieve information about a given user or yourself" description: "Microsoft Graph applications can use the Profile API to retrieve the profile of another user. "
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "people" doc_type: "conceptualPageType"
-# Use the Profile API in Microsoft Graph to retrieve information about yourself or another user
+# Use the Profile API in Microsoft Graph to retrieve information about yourself or another user
Namespace: microsoft.graph
-Microsoft Graph applications can use the Profile API to retrieve the profile of the signed-in user or another user with a valid Azure AD or Microsoft account. This information can be used in applications to assist in contextualizing another user, providing a richer experience for the user within the application or as a mechanism for storing extended information about the user which can also be used within Microsoft 365.
+Microsoft Graph applications can use the Profile API to retrieve the profile of the signed-in user or another user with a valid Azure AD or Microsoft account. This information can be used in applications to assist in contextualizing another user, providing a richer experience for the user within the application or as a mechanism for storing extended information about the user which can also be used within Microsoft 365.
## Authorization
To call the People API in Microsoft Graph, your app will need the appropriate pe
## View my profile
-The requests in this section get the people most relevant to the signed-in user (`/me`). These requests require the User.Read permission to be present for the signed-in user.
+The requests in this section get the people most relevant to the signed-in user (`/me`). These requests require the User.Read permission to be present for the signed-in user.
```http
v1.0 Report Identity Access https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/report-identity-access.md
Title: "Identity and access reports API overview" description: "Access identity and access reports to get the information about how people in your business are using applications in your Azure Active Directory tenant."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "identity-and-access-reports" doc_type: conceptualPageType
v1.0 Report https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/report.md
Title: "Working with Microsoft 365 usage reports in Microsoft Graph" description: "With Microsoft Graph, you can access Microsoft 365 usage reports resources to get the information about how people in your business are using Microsoft 365 services. For example, you can identify who is using a service a lot and reaching quotas, or who may not need a Microsoft 365 license at all."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "reports" doc_type: conceptualPageType
v1.0 Samlorwsfedexternaldomainfederation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/samlorwsfedexternaldomainfederation.md
+
+ Title: "samlOrWsFedExternalDomainFederation resource type"
+description: "Represents SAML/WS-Fed federation set up with an Azure Active Directory (Azure AD) tenant"
+
+localization_priority: medium
++
+# samlOrWsFedExternalDomainFederation resource type
+
+Namespace: microsoft.graph
++
+A resource that allows an Azure Active Directory (Azure AD) tenant to set up federation with another organization whose identity provider (IdP) supports either the SAML or WS-Fed protocol. This enables the Azure AD tenant to allow guest users to access its resources. For more information on SAML/WS-Fed IdP federation, see [Federation with SAML/WS-Fed identity providers for guest users](/azure/active-directory/external-identities/direct-federation).
+
+Inherits from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List samlOrWsFedExternalDomainFederations](../api/samlorwsfedexternaldomainfederation-list.md)|[samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) collection|Get a list of the [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) objects and their properties.|
+|[Create samlOrWsFedExternalDomainFederation](../api/samlorwsfedexternaldomainfederation-post.md)|[samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md)|Create a new [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object.|
+|[Get samlOrWsFedExternalDomainFederation](../api/samlorwsfedexternaldomainfederation-get.md)|[samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md)|Read the properties and relationships of a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object.|
+|[Update samlOrWsFedExternalDomainFederation](../api/samlorwsfedexternaldomainfederation-update.md)|[samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md)|Update the properties of a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object.|
+|[Delete samlOrWsFedExternalDomainFederation](../api/samlorwsfedexternaldomainfederation-delete.md)|None|Deletes a [samlOrWsFedExternalDomainFederation](../resources/samlorwsfedexternaldomainfederation.md) object.|
+|[List domains](../api/samlorwsfedexternaldomainfederation-list-domains.md)|[externalDomainName](../resources/externaldomainname.md) collection|Get the externalDomainName resources from the domains navigation property.|
+|[Create externalDomainName](../api/samlorwsfedexternaldomainfederation-post-domains.md)|[externalDomainName](../resources/externaldomainname.md)|Create a new externalDomainName object.|
+
+## Properties
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The display name of the SAML or WS-Fed based IdP. Inherited from [identityProviderBase](../resources/identityproviderbase.md).|
+|id|String|The identifier of the identity provider. Inherited from [entity](../resources/entity.md).|
+|issuerUri|String|Issuer URI of the federation server. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|metadataExchangeUri|String|URI of the metadata exchange endpoint used for authentication from rich client applications. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|passiveSignInUri|String|URI that web-based clients are directed to when signing in to Azure AD services. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|preferredAuthenticationProtocol|String|Preferred authentication protocol. Supported values include `saml` or `wsfed`. Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br/><br/> This property is used in the following scenarios: <ul><li> if a rollover is required outside of the autorollover update <li>a new federation service is being set up <li> if the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated. </ul> <br/><br/> Azure AD updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Azure AD monitors the metadata daily and will update the federation settings for the domain when a new certificate is available. <br/><br/> Inherited from [samlOrWsFedProvider](../resources/samlorwsfedprovider.md).|
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+|domains|[externalDomainName](../resources/externaldomainname.md) collection|Collection of domain names of the external organizations that the tenant is federating with. Supports `$filter` (`eq`).|
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.samlOrWsFedExternalDomainFederation",
+ "baseType": "microsoft.graph.samlOrWsFedProvider",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.samlOrWsFedExternalDomainFederation",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "issuerUri": "String",
+ "metadataExchangeUri": "String",
+ "signingCertificate": "String",
+ "passiveSignInUri": "String",
+ "preferredAuthenticationProtocol": "String"
+}
+```
v1.0 Samlorwsfedprovider https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/samlorwsfedprovider.md
+
+ Title: "samlOrWsFedProvider resource type"
+description: "Configuration details for setting up a SAML or WS-Fed based identity provider."
+
+localization_priority: medium
++
+# samlOrWsFedProvider resource type
+
+Namespace: microsoft.graph
++
+An abstract type that provides configuration details for setting up a SAML or WS-Fed external domain-based identity provider (IdP).
+
+Inherits from [identityProviderBase](../resources/identityproviderbase.md).
+
+## Properties
+
+|Property|Type|Description|
+|:|:|:|
+|displayName|String|The display name of the SAML/WS-Fed based identity provider. Inherited from [identityProviderBase](../resources/identityproviderbase.md).|
+|id|String|The identifier of the identity provider. Inherited from [entity](../resources/entity.md).|
+|issuerUri|String|Issuer URI of the federation server.|
+|metadataExchangeUri|String|URI of the metadata exchange endpoint used for authentication from rich client applications.|
+|passiveSignInUri|String|URI that web-based clients are directed to when signing in to Azure Active Directory (Azure AD) services.|
+|metadataExchangeUri|String|URI of the metadata exchange endpoint used for authentication from rich client applications.|
+|passiveSignInUri|String|URI that web-based clients are directed to when signing in to Azure AD services.|
+|preferredAuthenticationProtocol|String|Preferred authentication protocol. Supported values include `saml` or `wsfed`.|
+|signingCertificate|String|Current certificate used to sign tokens passed to the Microsoft identity platform. The certificate is formatted as a Base64 encoded string of the public portion of the federated IdP's token signing certificate and must be compatible with the X509Certificate2 class. <br/><br/> This property is used in the following scenarios: <ul><li> if a rollover is required outside of the autorollover update <li>a new federation service is being set up <li> if the new token signing certificate isn't present in the federation properties after the federation service certificate has been updated. </ul> <br/><br/> Azure AD updates certificates via an autorollover process in which it attempts to retrieve a new certificate from the federation service metadata, 30 days before expiry of the current certificate. If a new certificate isn't available, Azure AD monitors the metadata daily and will update the federation settings for the domain when a new certificate is available.|
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.samlOrWsFedProvider",
+ "baseType": "microsoft.graph.identityProviderBase",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.samlOrWsFedProvider",
+ "id": "String (identifier)",
+ "displayName": "String",
+ "issuerUri": "String",
+ "metadataExchangeUri": "String",
+ "signingCertificate": "String",
+ "passiveSignInUri": "String",
+ "preferredAuthenticationProtocol": "String"
+}
+```
v1.0 Schedulinggroup https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/schedulinggroup.md
Title: "schedulingGroup resource type" description: "A logical grouping of members in the schedule (usually by role)."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: resourcePageType
Namespace: microsoft.graph
[!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)]
-A logical grouping of users in a [schedule](schedule.md) (usually by role).
+A logical grouping of users in a [schedule](schedule.md) (usually by role).
## Methods
v1.0 Search Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/search-api-overview.md
Title: "Use the Microsoft Search API to query data" description: "Using the search API, apps can search Microsoft 365 data in the context of the authenticated user"
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "search" doc_type: resourcePageType
Control pagination of the search results by specifying the following two propert
Note the following limits if you're searching the **event** or **message** entity: - **from** must start at zero in the first page request; otherwise, the request results in an HTTP 400 `Bad request`.-- The maximum results per page (**size**) is 25 for **message** and **event**.
+- The maximum results per page (**size**) is 25 for **message** and **event**.
There is no upper limit for SharePoint or OneDrive items. A reasonable page size is 200. A larger page size generally incurs higher latency.
See [refine search results](/graph/search-concept-aggregation) for examples that
## Request spelling correction
-Spelling correction is a popular way to handle mismatches between typos in a user query and the correct words in matched contents. When typos are detected in the original user query, you can get the search result either for the original user query or the corrected alternate query. You can also get the spelling correction information for typos in the **queryAlterationResponse** property of the [searchresponse](searchresponse.md).
+Spelling correction is a popular way to handle mismatches between typos in a user query and the correct words in matched contents. When typos are detected in the original user query, you can get the search result either for the original user query or the corrected alternate query. You can also get the spelling correction information for typos in the **queryAlterationResponse** property of the [searchresponse](searchresponse.md).
In the request body of the [query](/graph/api/search-query?view=graph-rest-beta&preserve-view=true) method, specify the **queryAlterationOptions** that should be applied to the query for spelling corrections. The description of **queryAlterationOptions** is defined in the [searchAlterationOptions](./searchalterationoptions.md).
The search API allows you to render search results from [connectors](/microsofts
To get the result template in the [searchresponse](searchresponse.md), you have to set **true** the **enableResultTemplate** property, defined in the [resultTemplateOptions](./resulttemplateoption.md), in the [searchRequest](./searchrequest.md). The response includes a **resultTemplateId** for every [search hit](./searchhit.md), which maps to one of the display layouts included in the **resultTemplates** dictionary that is included in the response.
-See [Use search display layout](/graph/search-concept-display-layout) for examples.
+See [Use search display layout](/graph/search-concept-display-layout) for examples.
## Error handling
The search API has the following limitations:
- The **query** method is defined to allow passing a collection of one or more **searchRequest** instances at once. However, the service currently supports only a single [searchRequest](./searchrequest.md) at a time. - The [searchRequest](./searchrequest.md) resource supports passing multiple types of entities at a time. However, currently the only supported combination is for SharePoint and OneDrive entityTypes: **driveItem**, **drive**, **site**, **list**, **listItem**.
-Any combinations involving **message**, **event**, **person**, SharePoint and OneDrive types, or **externalItem** are currently not supported.
+Any combinations involving **message**, **event**, **person**, SharePoint and OneDrive types, or **externalItem** are currently not supported.
- The **contentSource** property, which defines the connection to use, is only applicable when **entityType** is specified as `externalItem`.
For backward compatibility, the original properties and types are accessible and
- Learn more about a few key use cases: - [Search Outlook messages](/graph/search-concept-messages) - [Search calendar events](/graph/search-concept-events)
- - [Search person](/graph/search-concept-person)
+ - [Search person](/graph/search-concept-person)
- [Search content in Sharepoint and OneDrive](/graph/search-concept-files) - [Search custom types imported using connectors](/graph/search-concept-custom-types) - [Sort search results](/graph/search-concept-sort)
v1.0 Security Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/security-api-overview.md
Title: "Use the Microsoft Graph Security API" description: " > **Important:** APIs under the /beta version in Microsoft Graph are in preview and are subject to change. Use of these APIs in production applications is not supported."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "security" doc_type: resourcePageType
v1.0 Selfservicesignupauthenticationflowconfiguration https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/selfservicesignupauthenticationflowconfiguration.md
Title: "selfServiceSignUpAuthenticationFlowConfiguration resource type" description: "Represents the configurations related to self-service sign-up."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "identity-and-access-reports" doc_type: resourcePageType
v1.0 Serviceprincipal https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/serviceprincipal.md
Title: "servicePrincipal resource type" description: "Represents an instance of an application in a directory. Inherits from directoryObject."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "applications"
v1.0 Sharepoint https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/sharepoint.md
Title: "Working with SharePoint sites in Microsoft Graph" description: "The SharePoint API in Microsoft Graph supports the following core scenarios:"
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "sharepoint" doc_type: conceptualPageType
v1.0 Site https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/site.md
description: "The site resource provides metadata and relationships for a SharePoint site." Last updated 09/10/2017 Title: Site
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "sites-and-lists" doc_type: resourcePageType
A **site** is identified by a unique ID that is a composite of the following val
* Site collection hostname (contoso.sharepoint.com) * Site collection unique ID (GUID) * Site unique ID (GUID)
-
+ The `root` identifier always references the root site for a given target, as follows: * `/sites/root`: The tenant root site.
v1.0 Social Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/social-overview.md
Title: "Use the Microsoft Graph API to integrate people and workplace intelligence in an app" description: "Microsoft Graph enables access to useful data about people, their profile, documents they interact with, and work patterns, and supports gestures in a user's social context."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "insights" doc_type: conceptualPageType
lets you browse, sort, select, filter, or search for persons based on your crite
Feature: Profile (preview)
-People who seek to contextualize others within their organization commonly view a person's profile or profile card.
+People who seek to contextualize others within their organization commonly view a person's profile or profile card.
-The [profile](../resources/profile.md) resource is a rich source of information about people within a tenant and provides a lightweight mechanism for storing and retrieving information about a person.
+The [profile](../resources/profile.md) resource is a rich source of information about people within a tenant and provides a lightweight mechanism for storing and retrieving information about a person.
## Personalize people experiences within your organization
v1.0 Socialidentityprovider https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/socialidentityprovider.md
Title: "socialIdentityProvider resource type" description: "Represents social identity providers in an Azure Active Directory tenant and an Azure AD B2C tenant."
-localization_priority: Priority
+ms.localizationpriority: high
doc_type: resourcePageType ms.prod: "identity-and-sign-in"
v1.0 Team https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/team.md
Title: "team resource type" description: "A team in Microsoft Teams is a collection of channels. "
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: resourcePageType
For a POST request example, see [Request (create team in migration state)](https
|installedApps|[teamsAppInstallation](teamsappinstallation.md) collection|The apps installed in this team.| |members|[conversationMember](../resources/conversationmember.md) collection|Members and owners of the team.| |owners|[user](user.md)| The list of this team's owners. Currently, when creating a team using application permissions, exactly one owner must be specified. When using user delegated permissions, no owner can be specified (the current user is the owner). Owner must be specified as an object ID (GUID), not a UPN. |
-|operations|[teamsAsyncOperation](teamsasyncoperation.md) collection| The async operations that ran or are running on this team. |
+|operations|[teamsAsyncOperation](teamsasyncoperation.md) collection| The async operations that ran or are running on this team. |
|photo|[profilePhoto](../resources/profilephoto.md)|The team photo.|
-|[primaryChannel](../api/team-get-primarychannel.md)|[channel](channel.md)| The general channel for the team. |
+|[primaryChannel](../api/team-get-primarychannel.md)|[channel](channel.md)| The general channel for the team. |
|schedule|[schedule](schedule.md)| The schedule of shifts for this team.| |template|[teamsTemplate](teamstemplate.md)| The template this team was created from. See [available templates](/MicrosoftTeams/get-started-with-teams-templates). | |permissionGrants|[resourceSpecificPermissionGrant](resourcespecificpermissiongrant.md) collection| A collection of permissions granted to apps to access the team.|
v1.0 Teams Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teams-api-overview.md
Title: "Use the Microsoft Graph API to work with Microsoft Teams" description: "Microsoft Teams is a chat-based workspace in Microsoft 365 that provides built-in access to team-specific calendars, files, OneNote notes, Planner plans, and more."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams" doc_type: conceptualPageType
These limits apply whether using Microsoft Teams directly or using Microsoft Gra
Because every team has a corresponding group, and every group is a directory object, limits on the [number of groups](/microsoft-365/admin/create-groups/office-365-groups#group-limits) and the [number of directory objects ("resources")](/azure/active-directory/users-groups-roles/directory-service-limits-restrictions)
-can also come into play.
+can also come into play.
Files inside channels are stored in SharePoint; [SharePoint online limits](/office365/servicedescriptions/sharepoint-online-service-description/sharepoint-online-limits) apply.
The following are the differences at the API level between teams and groups:
## Polling requirements
-If your app polls to see whether a resource has changed, you can only do that once per day.
-([teamsAsyncOperation](teamsasyncoperation.md) is an exception in that it's intended to be polled frequently.)
-If you need to hear about changes more frequently than that, you should [create a subscription](../api/subscription-post-subscriptions.md) to that resource and receive change notifications (webhooks).
-If you don't find support for the type of subscription you need, we encourage you to provide feedback via the [Microsoft 365 Developer Platform ideas forum](https://techcommunity.microsoft.com/t5/microsoft-365-developer-platform/idb-p/Microsoft365DeveloperPlatform/label-name/Microsoft%20Graph).
+If your app polls to see whether a resource has changed, you can only do that once per day.
+([teamsAsyncOperation](teamsasyncoperation.md) is an exception in that it's intended to be polled frequently.)
+If you need to hear about changes more frequently than that, you should [create a subscription](../api/subscription-post-subscriptions.md) to that resource and receive change notifications (webhooks).
+If you don't find support for the type of subscription you need, we encourage you to provide feedback via the [Microsoft 365 Developer Platform ideas forum](https://techcommunity.microsoft.com/t5/microsoft-365-developer-platform/idb-p/Microsoft365DeveloperPlatform/label-name/Microsoft%20Graph).
When polling for new messages, you must specify a date range where supported. For details, see [get channel messages delta](../api/chatmessage-delta.md).
-Polling is doing a GET operation on a resource over and over again to see if that resource has changed.
-You're allowed to GET the same resource multiple times a day, as long as it's not polling.
-For example, it is okay to GET /me/joinedTeams every time the user visits/refreshes your web page,
+Polling is doing a GET operation on a resource over and over again to see if that resource has changed.
+You're allowed to GET the same resource multiple times a day, as long as it's not polling.
+For example, it is okay to GET /me/joinedTeams every time the user visits/refreshes your web page,
but it is not okay to GET /me/joinedTeams in a loop every 30 seconds to refresh that web page. Apps that don't follow these polling requirements will be considered in violation of the
-[Microsoft APIs Terms of Use](/legal/microsoft-apis/terms-of-use). This may result in additional [throttling](/graph/throttling)
+[Microsoft APIs Terms of Use](/legal/microsoft-apis/terms-of-use). This may result in additional [throttling](/graph/throttling)
or the suspension or termination of your use of the Microsoft APIs. ## What's new
v1.0 Teamwork https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/teamwork.md
Title: "teamwork resource type"
description: "A container for Microsoft Teams features available for organization." doc_type: resourcePageType
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams"
v1.0 Threatassessment Api Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/threatassessment-api-overview.md
Title: "Use the Microsoft Graph threat assessment API" description: "Microsoft Graph lets your app get authorized access to organization's threat assessment data."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "security" doc_type: resourcePageType
v1.0 Todo Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/todo-overview.md
Title: "Use the Microsoft To Do API" description: "You can use the Microsoft Graph API to create an app that connects with tasks in Microsoft To Do."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "outlook" doc_type: conceptualPageType
Use the Microsoft Graph To Do API to create an app that connects with tasks acro
* Manage To Do tasks in a custom business application. Currently, the API supports only permissions delegated by the signed-in user.
-
+ Before starting with the To Do API, take a look at the resources and how they relate to one another. ![To Do API entities](/graph/images/todo-api-entities.png)
GET /me/todo/lists/{todoTaskListId}/tasks/{todoTaskId}/linkedresources/{linkedRe
## Track changes using delta query
-For performance reasons, you may want to maintain a local cache of objects, and periodically synchronize the local cache with the server, using [delta query](/graph/delta-query-overview).
+For performance reasons, you may want to maintain a local cache of objects, and periodically synchronize the local cache with the server, using [delta query](/graph/delta-query-overview).
The following To Do API resources support delta query: * [todoTask](./todotask.md) collection in a task list
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/user.md
Title: "user resource type" description: "Represents an Azure AD user account. Inherits from directoryObject."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "users" doc_type: resourcePageType
This resource supports:
|[Add app for user](../api/userteamwork-post-installedapps.md) | None | Adds (installs) an app in the personal scope of a user.| |[Remove app for user](../api/userteamwork-delete-installedapps.md) | None | Removes (uninstalls) an app in the personal scope of a user.| |[Upgrade app installed for user](../api/userteamwork-teamsappinstallation-upgrade.md) | None | Upgrades to the latest version of the app installed in the personal scope of a user.|
-|[Get chat between user and app](../api/userscopeteamsappinstallation-get-chat.md)| [Chat](chat.md)| Lists one-on-one chat between the user and the app. |
+|[Get chat between user and app](../api/userscopeteamsappinstallation-get-chat.md)| [Chat](chat.md)| Lists one-on-one chat between the user and the app. |
| **To-do tasks** ||| |[Create task](../api/todotasklist-post-tasks.md)|[todoTask](todotask.md)| Create a [todoTask](todotask.md) in the specified task list.| |[Create task list](../api/todo-post-lists.md) | [todoTaskList](todotasklist.md) | Create a To Do task list in the user's mailbox. |
This section explains how the three age group properties (**legalAgeGroupClassif
- **ageGroup** and **consentProvidedForMinor** are optional properties used by Azure AD administrators to help ensure the use of an account is handled correctly based on the age-related regulatory rules governing the user's country or region. For example: Cameron is administrator of a directory for an elementary school in Holyport in the United Kingdom. At the beginning of the school year he uses the admissions paperwork to obtain consent from the minor's parents based on the age-related regulations of the United Kingdom. The consent obtained from the parent allows the minor's account to be used by Holyport school and Microsoft apps. Cameron then creates all the accounts and sets ageGroup to "minor" and consentProvidedForMinor to "granted". Applications used by his students are then able to suppress features that are not suitable for minors.
-<!-- Note that the following 3 sub-sections are only documented like enums for a consistent user experience.
-For some reason they are not defined as enums in the CSDL.
+<!-- Note that the following 3 sub-sections are only documented like enums for a consistent user experience.
+For some reason they are not defined as enums in the CSDL.
Hence the type of the corresponding 3 properties remain as string type in the Properties table. -->
v1.0 Users https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/users.md
Title: "Working with users in Microsoft Graph" description: "Build compelling app experiences based on users, their relationships with other users and groups, and their mail, calendar, and files."
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "users" doc_type: conceptualPageType
v1.0 Userteamwork https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/userteamwork.md
Title: "userTeamwork resource type"
description: "A container for Microsoft Teams features available per user. " doc_type: resourcePageType
-localization_priority: Priority
+ms.localizationpriority: high
ms.prod: "microsoft-teams"
v1.0 Columndefinition Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/columndefinition-delete.md
++
+ Title: "Delete columnDefinition"
+description: "Delete a column from a site, a list, or a content type."
+localization_priority: Normal
++
+# Delete columnDefinition
+Namespace: microsoft.graph
++
+Remove a [column][columndefinition] from a [site][], a [list][], or a [content type][contentType].
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Manage.All, Sites.FullControl.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE /sites/{site-id}/columns/{column-id}
+DELETE /sites/{site-id}/lists/{list-id}/columns/{column-id}
+DELETE /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
+DELETE /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}/columns/{column-id}
+```
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_columns_from_contenttype"
+}
+-->
+
+```http
+DELETE https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+```http
+HTTP/1.1 204 No Content
+```
+
+[list]: ../resources/list.md
+[columndefinition]: ../resources/columndefinition.md
+[contentType]: ../resources/contentType.md
+[site]: ../resources/site.md
v1.0 Columndefinition Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/columndefinition-get.md
++
+ Title: "Get columnDefinition"
+description: "Get a site, a list, or a content type column."
+localization_priority: Normal
++
+# Get columnDefinition
+Namespace: microsoft.graph
++
+Retrieve the metadata for a [site][], a [list][], or a [contentType][] [column][columnDefinition].
+
+
+
+## Permissions
+
+
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+```http
+GET /sites/{site-id}/columns/{column-id}
+GET /sites/{site-id}/lists/{list-id}/columns/{column-id}
+GET /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
+GET /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}/columns/{column-id}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+
+
+Do not supply a request body with this method.
+
+
+
+## Example
+
+
+
+### Request
+
+<!-- { "blockType": "request", "name": "get_column_from_contenttype" } -->
+
+
+
+```http
+GET /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
+```
+
+### Response
+
+
+
+<!-- { "blockType": "response", "@type": "microsoft.graph.columnDefinition", "truncated": true } -->
+
+
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "description": "",
+ "displayName": "Title",
+ "hidden": false,
+ "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
+ "indexed": false,
+ "name": "Title",
+ "readOnly": false,
+ "required": false,
+ "text": {
+ "allowMultipleLines": false,
+ "appendChangesToExistingText": false,
+ "linesForEditing": 0,
+ "maxLength": 255
+ }
+}
+```
+
+
+
+[columnDefinition]: ../resources/columnDefinition.md
+
+[list]: ../resources/list.md
+
+[site]: ../resources/site.md
+
+[contentType]: ../resources/contentType.md
+
v1.0 Columndefinition Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/columndefinition-update.md
++
+ Title: "Update columnDefinition"
+description: "Update a site, a list, or a content type column."
+localization_priority: Normal
++
+# Update columnDefinition
+Namespace: microsoft.graph
++
+Update a [site][], a [list][], or a [content type][contentType] [column][columnDefinition].
+
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+```http
+PATCH /sites/{site-id}/columns/{column-id}
+PATCH /sites/{site-id}/lists/{list-id}/columns/{column-id}
+PATCH /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
+PATCH /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}/columns/{column-id}
+```
++
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
++
+## Request body
+
+In the request body, supply a JSON representation of those properties of a [columnDefinition][] resource to update. For best performance, don't include existing values that haven't changed.
+
+For columns in **site** or **list**, you can update any property of **columnDefinition** other than the **id** property.
+
+For columns in **contentType**, you can update only the **required** or **hidden** property.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [columnDefinition][] object in the response body.
+
+## Example
+
+### Request
+
+```http
+PATCH /sites/{site-id}/contentTypes/{contentType-id}/columns/{column-id}
+Content-Type: application/json
+
+{
+ "required": true,
+ "hidden": false,
+ "propagateChanges": false
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.columnDefinition"
+}
+-->
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "description": "",
+ "displayName": "Custom Column",
+ "enforceUniqueValues": false,
+ "hidden": false,
+ "id": "11dfef35-e2f7-4f17-82b0-6fba34445103",
+ "indexed": false,
+ "name": "Custom Column",
+ "readOnly": false,
+ "required": true,
+ "text": {
+ "allowMultipleLines": false,
+ "appendChangesToExistingText": false,
+ "linesForEditing": 0,
+ "maxLength": 255
+ }
+}
+```
+
+
+
+[columnDefinition]: ../resources/columnDefinition.md
+[contentType]: ../resources/contentType.md
+[list]: ../resources/list.md
+[site]: ../resources/site.md
+
v1.0 Contenttype Addcopy https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-addcopy.md
++
+ Title: "contentType: addCopy"
+description: "Add a copy of a site content type to a list."
+localization_priority: Normal
++
+# contentType: addCopy
+Namespace: microsoft.graph
++
+Add a copy of a [content type][contentType] from a [site][site] to a [list][list].
+
+
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) |Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+POST /sites/{site-id}/lists/{list-id}/contentTypes/addCopy
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Parameter|Type|Description|
+|-|-|-|
+|contentType| string | Canonical URL to the site content type that will be copied to the list. Required.|
+
+## Response
+
+If successful, this call returns a `201 Created` response code and a [contentType][] object in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "contenttype_addcopy"
+}
+-->
+```http
+POST https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/contentTypes/addCopy
+Content-Type: application/json
+
+{
+ "contentType": "https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes/0x0101"
+}
+```
++
+### Response
++
+<!-- { "blockType": "response", "@type": "microsoft.graph.contentType", "truncated": true} -->
+
+```http
+HTTP/1.1 201 Created
+
+{
+ "id": "0x0101",
+ "description": "Create a new custom CSR JavaScript Display Template.",
+ "group": "Display Template Content Types",
+ "hidden": false,
+ "name": "JavaScript Display Template",
+ "parentId": "0x01",
+ "readOnly": false,
+ "sealed": false,
+ "base": {
+ "id": "0x01",
+ "description": "Create a new custom CSR JavaScript Display Template.",
+ "group": "Display Template Content Types",
+ "hidden": false,
+ "name": "JavaScript Display Template",
+ "readOnly": false,
+ "sealed": false
+ }
+}
+```
+
+[site]: ../resources/site.md
+[list]: ../resources/list.md
+[contentType]: ../resources/contentType.md
v1.0 Contenttype Associatewithhubsites https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-associatewithhubsites.md
++
+ Title: "contentType: associateWithHubSites"
+description: "Associate a content type with a list of hub sites."
+localization_priority: Normal
++
+# contentType: associateWithHubSites
+
+Namespace: microsoft.graph
++
+Associate a published [content type][contentType] present in a content type hub with a list of hub sites.
+
+>**Note:** This feature is limited to tenants that have a SharePoint Syntex license.
+
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+POST /sites/{siteId}/contentTypes/{contentTypeId}/associateWithHubSites
+```
+>**Note:** The _siteId_ represents a content type hub site.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
+
+|Parameter|Type|Description|
+|-|-|-|
+|hubSiteUrls| Collection(string) |List of canonical URLs to the hub sites where the content type needs to be enforced. Required.|
+|propagateToExistingLists| Boolean |If `true`, content types will be enforced on existing lists in the hub sites; otherwise, it'll be applied only to newly created lists.|
+
+## Response
+
+If successful, this action returns a `204 No Content` response code.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "contenttype_associatewithhubsites"
+}
+-->
+```http
+POST https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes/{contentTypeId}/associateWithHubSites
+Content-Type: application/json
+
+{
+ "hubSiteUrls":[
+ "https://graph.microsoft.com/v1.0/sites/{site-id}"
+ ],
+ "propagateToExistingLists":false
+}
+```
+++++
+### Response
++
+<!-- { "blockType": "response" } -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+
+
+[contentType]: ../resources/contentType.md
v1.0 Contenttype Copytodefaultcontentlocation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-copytodefaultcontentlocation.md
++
+ Title: "contentType: copyToDefaultContentLocation"
+description: "Copy a file to a default content location in a content type."
+localization_priority: Normal
++
+# contentType: copyToDefaultContentLocation
+Namespace: microsoft.graph
++
+Copy a file to a default content location in a [content type][contentType]. The file can then be added as a default file or template via a POST operation.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+
+```http
+POST /sites/{siteId}/contentTypes/{contentTypeId}/copyToDefaultContentLocation
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply a JSON representation of the parameters.
+
+The following table shows the parameters that can be used with this action.
++
+|Parameter|Type|Description|
+|-|-|-|
+|sourceFile| [itemReference](../resources/itemreference.md) |Metadata about the source file that needs to be copied to the default content location. Required.|
+|destinationFileName| string |Destination filename. |
+
+## Response
++
+If successful, this call returns a `204 No Content` response.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "contenttype_copytodefaultcontentlocation"
+}
+-->
+```http
+POST https://graph.microsoft.com/v1.0/sites/{siteId}/contentTypes/{contentTypeId}/copyToDefaultContentLocation
+Content-Type: application/json
+
+{
+ "sourceFile":{
+ "sharepointIds":{
+ "listId":"e2ecf63b-b0fd-48f7-a54a-d8c15479e3b0",
+ "listItemId":"2"
+ }
+ },
+ "destinationFileName":"newname.txt"
+}
+```
+
+### Response
++
+<!-- { "blockType": "response" } -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+
+
+[contentType]: ../resources/contentType.md
v1.0 Contenttype Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-delete.md
++
+ Title: "Delete contentType"
+description: "Delete a content type from a SharePoint list or a site."
+localization_priority: Normal
++
+# Delete contentType
+Namespace: microsoft.graph
+++
+Remove a [content type][contentType] from a [list][] or a [site][].
++
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Manage.All, Sites.FullControl.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+DELETE /sites/{site-id}/contentTypes/{contentType-id}
+DELETE /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
++
+## Request body
+
+Do not supply a request body with this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_contenttype"
+}
+-->
+
+```http
+DELETE https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes/{contentType-id}
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+[list]: ../resources/list.md
+[contentType]: ../resources/contentType.md
+[site]: ../resources/site.md
v1.0 Contenttype Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-get.md
++
+ Title: "Get contentType"
+description: "Get a content type in a site or a list."
+localization_priority: Normal
++
+# Get contentType
+Namespace: microsoft.graph
+++
+Retrieve the metadata for a [content type][contentType] in a [site][] or a [list][].
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+
+## HTTP request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+GET /sites/{site-id}/contentTypes/{contentType-id}
+
+GET /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}
+```
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a [contentType](../resources/contenttype.md) object in the response body.
++
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "get_contenttype"
+}
+-->
+
+```http
+GET https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes/{contentType-id}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.contentType"
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "id":"0x0120D520",
+ "description":"Create a document set when you want to manage multiple documents as a single work product.",
+ "group":"Document Set Content Types",
+ "hidden":false,
+ "name":"Document Set",
+ "base": {
+ "name": "Document Set",
+ "id": "0x0120D520"
+ }
+}
+```
+
+[contentType]: ../resources/contentType.md
+[site]: ../resources/site.md
+[list]: ../resources/list.md
v1.0 Contenttype Ispublished https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-ispublished.md
++
+ Title: "contentType: isPublished"
+description: "Check the publishing status of a content type in a content type hub site."
+localization_priority: Normal
++
+# contentType: isPublished
+Namespace: microsoft.graph
++
+Check the publishing status of a [contentType][] in a content type hub site.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not Supported |
+|Application | Sites.FullControl.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /sites/{siteId}/contentTypes/{contentTypeId}/isPublished
+```
+>**Note:** The _siteId_ represents a content type hub site.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Response
+If successful, this call returns a `200 OK` response and a Boolean value that specifies the publishing status of the content type.
+
+## Request body
+Do not supply a request body for this method.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "contenttype_ispublished"
+}
+-->
+```http
+GET https://graph.microsoft.com/v1.0/sites/{siteId}/contentTypes/{contentTypeId}/isPublished
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "string"
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value": true
+}
+```
+
+[contentType]: ../resources/contentType.md
v1.0 Contenttype List Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-list-columns.md
++
+ Title: "List columnDefinitions in a content type"
+description: "List columns in a content type."
+localization_priority: Normal
++
+# List columnDefinitions in a content type
+Namespace: microsoft.graph
++
+Get the collection of columns represented as [columnDefinition][columnDefinition] resources in a [content type][contentType].
+
+
+
+## Permissions
+
+
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+GET /sites/{site-id}/contentTypes/{contentType-id}/columns
+GET /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}/columns
+```
+
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [columnDefinition][] objects in the response body.
+
+
+
+## Example
+
+### Request
+
+<!-- { "blockType": "request", "name": "get_columns_from_contenttype" } -->
+
+
+```http
+GET https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes/{contentType-id}/columns
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.columnDefinition",
+ "isCollection": true
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value":[
+ {
+ "description":"",
+ "displayName":"Title",
+ "hidden":false,
+ "id":"99ddcf45-e2f7-4f17-82b0-6fba34445103",
+ "indexed":false,
+ "name":"Title",
+ "readOnly":false,
+ "required":false,
+ "text":{
+ "allowMultipleLines":false,
+ "appendChangesToExistingText":false,
+ "linesForEditing":0,
+ "maxLength":255
+ }
+ },
+ {
+ "description":"",
+ "displayName":"Address",
+ "id":"11dfef35-e2f7-4f17-82b0-6fba34445103",
+ "indexed":false,
+ "name":"Address",
+ "readOnly":false,
+ "required":false,
+ "text":{
+ "allowMultipleLines":false,
+ "appendChangesToExistingText":false,
+ "linesForEditing":0,
+ "maxLength":255
+ }
+ }
+ ]
+}
+```
+
+
+
+[columnDefinition]: ../resources/columnDefinition.md
+[contentType]: ../resources/contentType.md
+
v1.0 Contenttype Post Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-post-columns.md
++ Last updated : 08/30/2020
+ Title: "Create a columnDefinition in a content type"
+description: "Add a column to a content type."
+localization_priority: Normal
++
+# Create a columnDefinition in a content type
+Namespace: microsoft.graph
++
+Add a column to a [content type][contentType] in a site, or a list with a request that specifies a [columnDefinition][columnDefinition].
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/concepts/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+```http
+POST /sites/{site-id}/contentTypes/{contentType-id}/columns
+POST /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}/columns
+```
+
+## Request body
+
+In the request body, supply a JSON representation of the [columnDefinition][] resource to add.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and [columnDefinition][] object in the response body.
+
+## Example
+
+### Request
+<!-- { "blockType": "request" } -->
+```http
+POST https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes/{contentType-id}/columns
+Content-Type: application/json
+
+{
+ "sourceColumn@odata.bind": "https://graph.microsoft.com/v1.0/sites/root/columns/99ddcf45-e2f7-4f17-82b0-6fba34445103"
+}
+```
+
+### Response
+
+The response returns the column added to a content type.
+
+<!-- { "blockType": "response", "@type": "microsoft.graph.columnDefinition", "truncated": true} -->
+
+
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "description": "",
+ "displayName": "Title",
+ "enforceUniqueValues": false,
+ "hidden": false,
+ "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
+ "indexed": false,
+ "name": "Title",
+ "text": {
+ "allowMultipleLines": false,
+ "appendChangesToExistingText": false,
+ "linesForEditing": 0,
+ "maxLength": 255
+ }
+}
+
+```
+
+
+
+[columnDefinition]: ../resources/columnDefinition.md
+[contentType]: ../resources/contentType.md
+
+
v1.0 Contenttype Publish https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-publish.md
++
+ Title: "contentType: publish"
+description: "Publish a content type present in the content type hub site."
+localization_priority: Normal
++
+# contentType: publish
+Namespace: microsoft.graph
++
+Publishes a [contentType][] present in the content type hub site.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Sites.FullControl.All |
+|Application | Sites.FullControl.All |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+POST /sites/{siteId}/contentTypes/{contentTypeId}/publish
+```
+
+>**Note:** The _siteId_ represents a content type hub site.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+If successful, this call returns a `204 No Content` response.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "contenttype_publish"
+}
+-->
+```http
+POST https://graph.microsoft.com/v1.0/sites/{siteId}/contentTypes/{contentTypeId}/publish
+```
+
+### Response
+
+<!-- { "blockType": "response" } -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+[contentType]: ../resources/contentType.md
v1.0 Contenttype Unpublish https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-unpublish.md
++
+ Title: "contentType: unpublish"
+description: "Unpublish a content type from a content type hub site."
+localization_priority: Normal
++
+# contentType: unpublish
+Namespace: microsoft.graph
++
+Unpublish a [contentType][] from a content type hub site.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Sites.FullControl.All |
+|Application | Sites.FullControl.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+POST /sites/{siteId}/contentTypes/{contentTypeId}/unpublish
+```
+
+>**Note:** The _siteId_ represents a content type hub site.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "contenttype_unpublish"
+}
+-->
+```http
+POST https://graph.microsoft.com/v1.0/sites/{siteId}/contentTypes/{contentTypeId}/unpublish
+```
+
+### Response
+
+<!-- { "blockType": "response" } -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+[contentType]: ../resources/contentType.md
v1.0 Contenttype Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/contenttype-update.md
++
+ Title: "Update contentType"
+description: "Update a content type."
+localization_priority: Normal
++
+# Update contentType
+Namespace: microsoft.graph
++
+Update a [content type][contentType].
+
+
+## Permissions
+
+
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application |Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+PATCH /sites/{site-id}/contentTypes/{contentType-id}
+PATCH /sites/{site-id}/lists/{list-id}/contentTypes/{contentType-id}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the [contentType][] resource to update.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an updated [contentType][] object in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "update_contenttype"
+}
+-->
+
+```http
+PATCH https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes/{contentType-id}
+Content-Type: application/json
+
+{
+ "name": "updatedCt",
+ "documentSet": {
+ "shouldPrefixNameToFile": true,
+ "allowedContentTypes": [{
+ "id": "0x0101",
+ "name": "Document"
+ }],
+ "defaultContents": [{
+ "fileName": "a.txt",
+ "contentType": {
+ "id": "0x0101"
+ }
+ },
+ {
+ "fileName": "b.txt",
+ "contentType": {
+ "id": "0x0101"
+ }
+ }
+ ],
+ "sharedColumns": [{
+ "name": "Description",
+ "id": "cbb92da4-fd46-4c7d-af6c-3128c2a5576e"
+ },
+ {
+ "name": "Address",
+ "id": "fc2e188e-ba91-48c9-9dd3-16431afddd50"
+ }
+ ],
+ "welcomePageColumns": [{
+ "name": "Address",
+ "id": "fc2e188e-ba91-48c9-9dd3-16431afddd50"
+ }]
+ }
+}
+
+```
++
+### Response
+
+<!-- { "blockType": "response", "@type": "microsoft.graph.contentType", "truncated": true} -->
+
+
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "id": "0x0101009B237E76EF94DC49B4E58139041E7C60",
+ "description": "",
+ "eTag": "\"7\"",
+ "group": "Custom Content Types",
+ "hidden": false,
+ "name": "testdoc",
+ "parentId": "0x0101",
+ "base": {
+ "id": "0x0101",
+ "name": "Document"
+ }
+}
+
+```
+
+[contentType]: ../resources/contentType.md
v1.0 List List Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/list-list-columns.md
++
+ Title: "List columnDefinitions in a list"
+description: "List columns in a list."
+localization_priority: Normal
++
+# List columnDefinitions in a list
+Namespace: microsoft.graph
+
+Get the collection of columns represented as [columnDefinition][columnDefinition] resources in a [list][list].
+
+
+
+## Permissions
+
+
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+GET /sites/{site-id}/lists/{list-id}/columns
+```
+
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [columnDefinition][] objects in the response body.
+
+
+
+## Example
+
+### Request
+
+<!-- { "blockType": "request", "name": "get_columns_from_list" } -->
+
+
+```http
+GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/columns
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.columnDefinition",
+ "isCollection": true
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value": [
+ {
+ "description": "",
+ "displayName": "Title",
+ "hidden": false,
+ "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
+ "indexed": false,
+ "name": "Title",
+ "readOnly": false,
+ "required": false,
+ "text": {
+ "allowMultipleLines": false,
+ "appendChangesToExistingText": false,
+ "linesForEditing": 0,
+ "maxLength": 255
+ }
+ },
+ {
+ "description": "",
+ "displayName": "Address",
+ "id": "11dfef35-e2f7-4f17-82b0-6fba34445103",
+ "indexed": false,
+ "name": "Address",
+ "readOnly": false,
+ "required": false,
+ "text": {
+ "allowMultipleLines": false,
+ "appendChangesToExistingText": false,
+ "linesForEditing": 0,
+ "maxLength": 255
+ }
+ }
+ ]
+}
+```
+
+
+
+[columnDefinition]: ../resources/columnDefinition.md
+[list]: ../resources/list.md
+
v1.0 List List Contenttypes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/list-list-contenttypes.md
++
+ Title: "List contentTypes in a list"
+description: "Get the collection of content types in a list."
+localization_priority: Normal
++
+# List contentTypes in a list
+Namespace: microsoft.graph
+
+Get the collection of [contentType][contentType] resources in a [list][].
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+
+## HTTP request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+GET /sites/{site-id}/lists/{list-id}/contentTypes
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [contentType](../resources/contenttype.md) objects in the response body.
+
+## Example
+
+### Request
+
+<!-- { "blockType": "request", "name": "enum_contentTypes"} -->
+
+```http
+GET https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/contentTypes
+```
++
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.contentType",
+ "isCollection": true
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value": [
+ {
+ "id":"0x",
+ "description":"",
+ "group":"_Hidden",
+ "hidden":false,
+ "name":"System",
+ "base": {
+ "name": "System",
+ "id": "0x"
+ }
+ },
+ {
+ "id":"0x00A7470EADF4194E2E9ED1031B61DA0884",
+ "name": "docSet",
+ "description": "custom docset",
+ "hidden":false,
+ "base": {
+ "name": "Document Set",
+ "id": "0x0120D520"
+ },
+ "group": "Custom Content Types"
+ }
+ ]
+}
+```
++
+[contentType]: ../resources/contentType.md
+[list]: ../resources/list.md
v1.0 List Post Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/list-post-columns.md
++ Last updated : 08/30/2020
+ Title: "Create a columnDefinition in a list"
+description: "Create a list column."
+localization_priority: Normal
++
+# Create a columnDefinition in a list
+Namespace: microsoft.graph
+
+Create a column for a [list][list] with a request that specifies a [columnDefinition][columnDefinition].
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/concepts/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+```http
+POST /sites/{site-id}/lists/{list-id}/columns
+```
+
+## Request body
+
+In the request body, supply a JSON representation of the [columnDefinition][] resource to add.
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [columnDefinition][] object in the response body.
+
+## Example
+
+### Request
+<!-- { "blockType": "request" } -->
+```http
+POST https://graph.microsoft.com/v1.0/sites/{site-id}/lists/{list-id}/columns
+Content-Type: application/json
+
+{
+ "description": "test",
+ "enforceUniqueValues": false,
+ "hidden": false,
+ "indexed": false,
+ "name": "Title",
+ "text": {
+ "allowMultipleLines": false,
+ "appendChangesToExistingText": false,
+ "linesForEditing": 0,
+ "maxLength": 255
+ }
+}
+```
+
+### Response
+
+<!-- { "blockType": "response", "@type": "microsoft.graph.columnDefinition", "truncated": true } -->
+
+
+
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "description": "test",
+ "displayName": "Title",
+ "enforceUniqueValues": false,
+ "hidden": false,
+ "id": "99ddcf45-e2f7-4f17-82b0-6fba34445103",
+ "indexed": false,
+ "name": "Title",
+ "text": {
+ "allowMultipleLines": false,
+ "appendChangesToExistingText": false,
+ "linesForEditing": 0,
+ "maxLength": 255
+ }
+}
+
+```
+
+
+
+[columnDefinition]: ../resources/columnDefinition.md
+[list]: ../resources/list.md
+
+
v1.0 Site Getapplicablecontenttypesforlist https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-getapplicablecontenttypesforlist.md
++
+ Title: "site: getApplicableContentTypesForList"
+description: "Get site content types that can be added to a list."
+localization_priority: Normal
++
+# site: getApplicableContentTypesForList
+Namespace: microsoft.graph
+++
+Get [site][] [contentTypes][contentType] that can be added to a list.
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+GET /sites/{siteId}/getApplicableContentTypesForList
+```
+
+## Function parameters
+In the request URL, provide the following query parameters with values.
+The following table shows the parameters that can be used with this function.
+
+|Parameter|Type|Description|
+|-|-|-|
+|listId| String | GUID of the list for which the applicable content types need to be fetched. Required. |
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+To list only custom content types, use `$filter=isBuiltin eq false`.
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this function returns a `200 OK` response code and a [contentType](../resources/contenttype.md) collection in the response body.
+
+## Example
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "site_getapplicablecontenttypesforlist"
+}
+-->
+```http
+GET https://graph.microsoft.com/v1.0/sites/{siteId}/getApplicableContentTypesForList(listId='listId')
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.contentType",
+ "isCollection": true
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value": [
+ {
+ "id":"0x",
+ "description":"",
+ "group":"_Hidden",
+ "hidden":false,
+ "name":"System",
+ "base": {
+ "name": "System",
+ "id": "0x"
+ }
+ },
+ {
+ "id":"0x00A7470EADF4194E2E9ED1031B61DA0884",
+ "name": "docSet",
+ "description": "custom docset",
+ "hidden":false,
+ "base": {
+ "name": "Document Set",
+ "id": "0x0120D520"
+ },
+ "group": "Custom Content Types"
+ }
+ ]
+}
+```
+
+[contentType]: ../resources/contentType.md
+[site]: ../resources/site.md
v1.0 Site List Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-list-columns.md
++
+ Title: "List columns in a site"
+description: "Get the collection of columns in a site."
+localization_priority: Normal
++
+# List columns in a site
+Namespace: microsoft.graph
++
+Get the collection of columns represented as [columnDefinition][columnDefinition] resources in a [site][site].
+
+
+
+## Permissions
+
+
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+GET /sites/{site-id}/columns
+```
+
+
+## Optional query parameters
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [columnDefinition][] objects in the response body.
+
+
+
+## Example
+
+### Request
+
+<!-- { "blockType": "request", "name": "get_columns_from_site" } -->
+
+
+```http
+GET https://graph.microsoft.com/v1.0/sites/{site-id}/columns
+```
++
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.columnDefinition",
+ "isCollection": true
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value":[
+ {
+ "description":"",
+ "displayName":"Title",
+ "hidden":false,
+ "id":"99ddcf45-e2f7-4f17-82b0-6fba34445103",
+ "indexed":false,
+ "name":"Title",
+ "readOnly":false,
+ "required":false,
+ "text":{
+ "allowMultipleLines":false,
+ "appendChangesToExistingText":false,
+ "linesForEditing":0,
+ "maxLength":255
+ }
+ },
+ {
+ "description":"",
+ "displayName":"Address",
+ "id":"11dfef35-e2f7-4f17-82b0-6fba34445103",
+ "indexed":false,
+ "name":"Address",
+ "readOnly":false,
+ "required":false,
+ "text":{
+ "allowMultipleLines":false,
+ "appendChangesToExistingText":false,
+ "linesForEditing":0,
+ "maxLength":255
+ }
+ }
+ ]
+}
+```
+
+
+
+[columnDefinition]: ../resources/columnDefinition.md
+[site]: ../resources/site.md
+
v1.0 Site List Contenttypes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-list-contenttypes.md
++
+ Title: "List contentTypes in a site"
+description: "Get the collection of content types in a site."
+localization_priority: Normal
++
+# List contentTypes in a site
+Namespace: microsoft.graph
++
+Get the collection of [contentType][contentType] resources in a [site][].
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions_reference.md).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Read.All, Sites.ReadWrite.All, Sites.Manage.All, Sites.FullControl.All |
+
+## HTTP request
+<!-- {
+ "blockType": "ignored"
+}
+-->
+```http
+GET /sites/{site-id}/contentTypes
+```
+
+## Optional query parameters
+
+This method supports some of the OData query parameters to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and a collection of [contentType](../resources/contenttype.md) objects in the response body.
+
+## Example
+
+### Request
+
+<!-- { "blockType": "request", "name": "enum_contentTypes"} -->
+
+```http
+GET https://graph.microsoft.com/v1.0/sites/{site-id}/contentTypes
+```
+
+### Response
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.contentType",
+ "isCollection": true
+}
+-->
+
+```http
+HTTP/1.1 200 OK
+Content-type: application/json
+
+{
+ "value": [
+ {
+ "id":"0x",
+ "description":"",
+ "group":"_Hidden",
+ "hidden":false,
+ "name":"System",
+ "base": {
+ "name": "System",
+ "id": "0x"
+ }
+ },
+ {
+ "id":"0x00A7470EADF4194E2E9ED1031B61DA0884",
+ "name": "docSet",
+ "description": "custom docset",
+ "hidden":false,
+ "base": {
+ "name": "Document Set",
+ "id": "0x0120D520"
+ },
+ "group": "Custom Content Types"
+ }
+ ]
+}
+```
++
+[contentType]: ../resources/contentType.md
+[site]: ../resources/site.md
v1.0 Site Post Columns https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-post-columns.md
++ Last updated : 08/30/2020
+ Title: "Create a columnDefinition in a site"
+description: "Create a site column."
+localization_priority: Normal
++
+# Create a columnDefinition in a site
+Namespace: microsoft.graph
+
+Create a column for a [site][site] with a request that specifies a [columnDefinition][columnDefinition].
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/concepts/permissions_reference.md).
+
+
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) | Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) | Not supported. |
+|Application | Sites.Manage.All, Sites.FullControl.All |
+
+
+
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+```http
+POST /sites/{site-id}/columns
+```
+
+## Request body
+
+In the request body, supply a JSON representation of the [columnDefinition][] resource to add.
+
+## Response
+
+If successful, this method returns a `201 Created` response code and [columnDefinition][] object in the response body.
+
+## Example
+
+### Request
+<!-- { "blockType": "request", "name": "site_post_columns" } -->
+```http
+POST https://graph.microsoft.com/v1.0/sites/{site-id}/columns
+Content-Type: application/json
+
+{
+ "description":"test",
+ "enforceUniqueValues":false,
+ "hidden":false,
+ "indexed":false,
+ "name":"Title",
+ "text":{
+ "allowMultipleLines":false,
+ "appendChangesToExistingText":false,
+ "linesForEditing":0,
+ "maxLength":255
+ }
+}
+```
+
+### Response
+
+<!-- { "blockType": "response", "@type": "microsoft.graph.columnDefinition", "truncated": true } -->
+
+
+
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "description":"test",
+ "displayName":"Title",
+ "enforceUniqueValues":false,
+ "hidden":false,
+ "id":"99ddcf45-e2f7-4f17-82b0-6fba34445103",
+ "indexed":false,
+ "name":"Title",
+ "text":{
+ "allowMultipleLines":false,
+ "appendChangesToExistingText":false,
+ "linesForEditing":0,
+ "maxLength":255
+ }
+}
+```
+
+
+
+[columnDefinition]: ../resources/columnDefinition.md
+[site]: ../resources/site.md
+
+
v1.0 Site Post Contenttypes https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/site-post-contenttypes.md
++
+ Title: "Create a content type"
+description: "Create a content type in a site."
+localization_priority: Normal
++
+# Create a content type
+Namespace: microsoft.graph
+
+Create a new [contentType][] in a [site][].
+
+## Permissions
+
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type | Permissions (from least to most privileged) |
+|:--|:|
+|Delegated (work or school account) |Sites.Manage.All, Sites.FullControl.All |
+|Delegated (personal Microsoft account) |Not Supported |
+|Application |Sites.Manage.All, Sites.FullControl.All |
++
+## HTTP request
+
+<!-- { "blockType": "ignored" } -->
+
+```http
+POST /sites/{site-id}/contentTypes
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the [contentType][] resource to create.
+
+## Response
+
+If successful, this method returns a `201 Created` response code and a [contentType][] object in the response body.
++
+## Example
+
+The following example shows how to create a new generic content type.
+
+### Request
+
+<!-- {
+ "blockType": "request",
+ "name": "create_contenttype"
+}
+-->
+
+```http
+POST https://graph.microsoft.com/v1.0/sites/{id}/contentTypes
+Content-Type: application/json
+
+{
+ "name": "docSet",
+ "description": "custom docset",
+ "base": {
+ "name": "Document Set",
+ "id": "0x0120D520"
+ },
+ "group": "Document Set Content Types"
+}
+```
+
+### Response
+>**Note:** The response object shown here might be shortened for readability.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.contentType"
+}
+-->
+
+```http
+HTTP/1.1 201 Created
+Content-type: application/json
+
+{
+ "id": "0x01002A2479FF33DD4BC3B1533A012B653717",
+ "name": "docSet",
+ "group":"Document Set Content Types",
+ "description" : "custom docset",
+ "base": {
+ "name": "Document Set",
+ "id": "0x0120D520"
+ }
+}
+```
++
+[contentType]: ../resources/contentType.md
+[site]: ../resources/site.md
+
+<!--
+{
+ "type": "#page.annotation",
+ "description": "Create a content type in a site",
+ "keywords": "content type",
+ "section": "documentation",
+ "tocPath": "sites/Create ContentType",
+ "suppressions": [
+ ]
+}
+-->
v1.0 Columndefinition https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/columndefinition.md
+description: "Represents a column in a site, a list, or a content type."
Last updated 09/11/2017 Title: ColumnDefinition
+ Title: columnDefinition resource type
localization_priority: Normal
-description: "Here is a JSON representation of a ColumnDefinition resource."
doc_type: resourcePageType
-# ColumnDefinition resource
+# columnDefinition resource type
Namespace: microsoft.graph +
+Represents a column in a [site][], [list][], or [contentType][].
++
+ColumnDefinitions and field values for `hidden` columns aren't shown by default.
+To list hidden **columnDefinitions**, include `hidden` in your `$select` statement.
+To list hidden **field** values on [listItems][listItem], include the desired columns by name in your `$select` statement.
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List columns in a site](../api/site-list-columns.md)|[columnDefinition](../resources/columndefinition.md) collection|Get a list of the [columnDefinition](../resources/columndefinition.md) objects and their properties in a [site](../resources/site.md).|
+|[List columns in a list](../api/list-list-columns.md)|[columnDefinition](../resources/columndefinition.md) collection|Get a list of the [columnDefinition](../resources/columndefinition.md) objects and their properties in a [list](../resources/list.md).|
+|[List columns in a content type](../api/contenttype-list-columns.md)|[columnDefinition](../resources/columndefinition.md) collection|Get a list of the [columnDefinition](../resources/columndefinition.md) objects and their properties in a [content type](../resources/contenttype.md).|
+|[Create columnDefinition for a site](../api/site-post-columns.md)|[columnDefinition](../resources/columndefinition.md)|Create a new [columnDefinition](../resources/columndefinition.md) object in a [site](../resources/site.md).|
+|[Create columnDefinition for a list](../api/list-post-columns.md)|[columnDefinition](../resources/columndefinition.md)|Create a new [columnDefinition](../resources/columndefinition.md) object in a [list](../resources/list.md).|
+|[Create columnDefinition for a content type](../api/contenttype-post-columns.md)|[columnDefinition](../resources/columndefinition.md)|Create a new [columnDefinition](../resources/columndefinition.md) object in a [content type](../resources/contenttype.md).|
+|[Get columnDefinition](../api/columndefinition-get.md)|[columnDefinition](../resources/columndefinition.md)|Read the properties and relationships of a [columnDefinition](../resources/columndefinition.md) object.|
+|[Update columnDefinition](../api/columndefinition-update.md)|[columnDefinition](../resources/columndefinition.md)|Update the properties of a [columnDefinition](../resources/columndefinition.md) object.|
+|[Delete columnDefinition](../api/columndefinition-delete.md)|None|Deletes a [columnDefinition](../resources/columndefinition.md) object.|
+
+## Properties
+
+Columns can hold data of various types.
+The following properties indicate what type of data a column stores, as well as additional settings for that data.
+The type-related properties (boolean, calculated, choice, currency, dateTime, lookup, number, personOrGroup, text, term, hyperlinkOrPicture, thumbnail, and contentApprovalStatus) are mutually exclusive; a column can only have one of them specified.
+
+| Property name | Type | Description|
+|:|:--|:--|
+| **columnGroup** | string | For site columns, the name of the group this column belongs to. Helps organize related columns.|
+| **description** | string | The user-facing description of the column.|
+| **displayName** | string | The user-facing name of the column.|
+| **enforceUniqueValues** | Boolean | If `true`, no two list items may have the same value for this column.|
+| **hidden** | Boolean | Specifies whether the column is displayed in the user interface.|
+| **id** | string | The unique identifier for the column.|
+| **indexed** | Boolean | Specifies whether the column values can be used for sorting and searching.|
+| **name** | string | The API-facing name of the column as it appears in the [fields][] on a [listItem][]. For the user-facing name, see **displayName**.|
+| **readOnly** | Boolean | Specifies whether the column values can be modified.|
+| **required** | Boolean | Specifies whether the column value isn't optional.|
+| **boolean** | [booleanColumn][] | This column stores boolean values.|
+| **calculated** | [calculatedColumn][] | This column's data is calculated based on other columns.|
+| **choice** | [choiceColumn][] | This column stores data from a list of choices.|
+| **currency** | [currencyColumn][] | This column stores currency values.|
+| **dateTime** | [dateTimeColumn][] | This column stores DateTime values.|
+| **defaultValue** | [defaultColumnValue][] | The default value for this column.|
+| **geolocation** | [geolocationColumn][] | This column stores a geolocation.|
+| **lookup** | [lookupColumn][] | This column's data is looked up from another source in the site.|
+| **number** | [numberColumn][] | This column stores number values.|
+| **personOrGroup** | [personOrGroupColumn][] | This column stores Person or Group values.|
+| **text** | [textColumn][] | This column stores text values.|
+| **isDeletable** | Boolean | Indicates whether this column can be deleted.|
+| **propagateChanges** | Boolean | If 'true', changes to this column will be propagated to lists that implement the column. |
+| **isReorderable** | Boolean | Indicates whether values in the column can be reordered. Read-only.|
+| **isSealed** | Boolean | Specifies whether the column can be changed.|
+| **validation** | [columnValidation][] | This column stores validation formula and message for the column.|
+| **hyperlinkOrPicture** | [hyperlinkOrPictureColumn][] | This column stores hyperlink or picture values. |
+| **term** | [termColumn][] | This column stores taxonomy terms.|
+| **sourceContentType** |[contentTypeInfo][] | ContentType from which this column is inherited from. Present only in contentTypes columns response. Read-only.|
+| **thumbnail** |[thumbnailColumn][] | This column stores thumbnail values.|
+| **type** | columnTypes | For site columns, the type of column. Read-only.|
+| **contentApprovalStatus**| [contentApprovalStatusColumn][] | This column stores content approval status.|
+
+## Relationships
+
+| Property name | Type | Description|
+|:-|:--|:-|
+| **sourceColumn** | [columnDefinition][] | The source column for the content type column.|
+
+>**Note:** These properties correspond to the SharePoint [SPFieldType][] enumeration.
+Note that the most common field types are represented in the previous table. However, this API is still missing some.
+In those cases, none of the column type facets will be populated, and the column will only have its basic properties.
+Sites and list columns response won't contain **isDeletable**, **propagateChanges**, **isReorderable**, **isSealed**, **validation**, **hyperlinkOrPicture**, **term**, **sourceContentType**, **thumbnail**, **type**, **contentApprovalStatus**, and **sourceColumn** properties.
+ ## JSON representation
-Here is a JSON representation of a ColumnDefinition resource.
+Here is a JSON representation of a columnDefinition resource.
<!--{ "blockType": "resource",
Here is a JSON representation of a ColumnDefinition resource.
"columnGroup": "string", "description": "description", "displayName": "friendly name",
- "enforceUniqueValues": "true",
+ "enforceUniqueValues": true,
"hidden": false, "id": "string", "indexed": true,
Here is a JSON representation of a ColumnDefinition resource.
"lookup": { "@odata.type": "microsoft.graph.lookupColumn" }, "number": { "@odata.type": "microsoft.graph.numberColumn" }, "personOrGroup": { "@odata.type": "microsoft.graph.personOrGroupColumn" },
- "text": { "@odata.type": "microsoft.graph.textColumn" }
+ "text": { "@odata.type": "microsoft.graph.textColumn" },
+ "isDeletable" : false,
+ "propagateChanges": false,
+ "isReorderable": false,
+ "isSealed": false,
+ "validation": { "@odata.type": "microsoft.graph.columnValidation" },
+ "hyperlinkOrPicture": { "@odata.type": "microsoft.graph.hyperlinkOrPictureColumn" },
+ "term": { "@odata.type": "microsoft.graph.termColumn" },
+ "sourceContentType": { "@odata.type": "microsoft.graph.contentTypeInfo" },
+ "thumbnail": { "@odata.type": "microsoft.graph.thumbnailColumn" },
+ "type": { "@odata.type": "microsoft.graph.columnTypes" },
+ "contentApprovalStatus": { "@odata.type": "microsoft.graph.contentApprovalStatusColumn" }
} ```
-## Properties
-
-The **columnDefinition** resource has the following properties.
-
-| Property name | Type | Description
-|:|:--|:--
-| **columnGroup** | string | For site columns, the name of the group this column belongs to. Helps organize related columns.
-| **description** | string | The user-facing description of the column.
-| **displayName** | string | The user-facing name of the column.
-| **enforceUniqueValues** | boolean | If true, no two list items may have the same value for this column.
-| **hidden** | boolean | Specifies whether the column is displayed in the user interface.
-| **id** | string | The unique identifier for the column.
-| **indexed** | boolean | Specifies whether the column values can used for sorting and searching.
-| **name** | string | The API-facing name of the column as it appears in the [fields][] on a [listItem][]. For the user-facing name, see **displayName**.
-| **readOnly** | bool | Specifies whether the column values can be modified.
-| **required** | boolean | Specifies whether the column value is not optional.
-
-Columns can hold data of various types.
-The following properties indicate what type of data a column stores, as well as additional settings for that data.
-These properties are mutually exclusive -- a column can only have one of them specified.
-
-| Property name | Type | Description
-|:|:|:-
-| **boolean** | [booleanColumn][] | This column stores boolean values.
-| **calculated** | [calculatedColumn][] | This column's data is calculated based on other columns.
-| **choice** | [choiceColumn][] | This column stores data from a list of choices.
-| **currency** | [currencyColumn][] | This column stores currency values.
-| **dateTime** | [dateTimeColumn][] | This column stores DateTime values.
-| **defaultValue** | [defaultColumnValue][] | The default value for this column.
-| **geolocation** | [geolocationColumn][] | This column stores a geolocation.
-| **lookup** | [lookupColumn][] | This column's data is looked up from another source in the site.
-| **number** | [numberColumn][] | This column stores number values.
-| **personOrGroup** | [personOrGroupColumn][] | This column stores Person or Group values.
-| **text** | [textColumn][] | This column stores text values.
-
-Note: These properties correspond to SharePoint's [SPFieldType][] enumeration.
-While the most common field types are represented above, this API is still missing some.
-In those cases, none of the column type facets will be populated, and the column will only have its basic properties.
-
-## Remarks
-
-ColumnDefinitions and field values for `hidden` columns are not shown by default.
-To see them when listing **columnDefinitions**, include `hidden` in your `$select` statement.
-To see them when showing **field** values on [listItems][listItem], include the desired columns by name in your `$select` statement.
- [booleanColumn]: booleancolumn.md [calculatedColumn]: calculatedcolumn.md [choiceColumn]: choicecolumn.md
+[columnDefinition]: columnDefinition.md
+[contentType]: contenttype.md
[currencyColumn]: currencycolumn.md [dateTimeColumn]: datetimecolumn.md [defaultColumnValue]: defaultcolumnvalue.md [geolocationColumn]: geolocationcolumn.md
+[list]: list.md
[lookupColumn]: lookupcolumn.md [numberColumn]: numbercolumn.md [personOrGroupColumn]: personorgroupcolumn.md
+[site]: site.md
[textColumn]: textcolumn.md [fieldValueSet]: fieldvalueset.md [fields]: fieldvalueset.md [listItem]: listitem.md
+[termColumn]: termColumn.md
+[contentApprovalStatusColumn]: contentApprovalStatusColumn.md
+[thumbnailColumn]: thumbnailColumn.md
+[hyperlinkOrPictureColumn]: hyperlinkOrPictureColumn.md
+[columnValidation]: columnValidation.md
+[contentTypeInfo]: contentTypeInfo.md
[SPFieldType]: /previous-versions/office/sharepoint-server/ms428806(v=office.15)
-<!-- {
+<!--
+{
"type": "#page.annotation", "description": "", "keywords": "", "section": "documentation",
- "tocPath": "Resources/ColumnDefinition"
-} -->
+ "tocPath": "Resources/ColumnDefinition",
+ "suppressions": []
+}
+-->
v1.0 Columnvalidation https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/columnvalidation.md
++
+ Title: "columnValidation resource type"
+description: "Contains data that validates column values."
+localization_priority: Normal
++
+# columnValidation resource type
+
+Namespace: microsoft.graph
+
+Represents properties that validates column values.
+## Properties
+
+| Property name | Type | Description|
+|:|:--|:--|
+| **formula** | string | The formula to validate column value. For examples, see [Examples of common formulas in lists](https://support.microsoft.com/office/examples-of-common-formulas-in-sharepoint-lists-d81f5f21-2b4e-45ce-b170-bf7ebf6988b3).|
+| **descriptions** | Collection(microsoft.graph.displayNameLocalization) | Localized messages that explain what is needed for this column's value to be considered valid. User will be prompted with this message if validation fails. |
+| **defaultLanguage** | string | Default BCP 47 language tag for the description.|
+
+SharePoint formulas use a syntax similar to Excel formulas.
+For more information, see [Examples of common formulas in SharePoint Lists][SPFormulas].
+
+## JSON representation
+
+The following is a JSON representation of a **columnValidation** resource.
+<!-- { "blockType": "resource", "@odata.type": "microsoft.graph.columnValidation"} -->
+
+```json
+{
+ "formula": "string",
+ "descriptions": [{ "@type": "microsoft.graph.displayNameLocalization" }],
+ "defaultLanguage": "string"
+}
+```
+
+[SPFormulas]: https://support.office.com/article/Examples-of-common-formulas-in-SharePoint-Lists-d81f5f21-2b4e-45ce-b170-bf7ebf6988b3
v1.0 Contenttype https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/contentType.md
Previously updated : 09/12/2017 Title: ContentType
-localization_priority: Normal
description: "The contentType resource represents a content type in SharePoint."
+ Title: contentType resource type
+localization_priority: Normal
doc_type: resourcePageType
-# ContentType resource type
+# contentType resource type
Namespace: microsoft.graph
-The **contentType** resource represents a _content type_ in SharePoint.
+
+Represents a content type in SharePoint.
Content types allow you to define a set of columns that must be present on every [**listItem**][listItem] in a [**list**][list].
-[list]: list.md
-[listItem]: listitem.md
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List contentTypes in a site](../api/site-list-contenttypes.md)|[contentType](../resources/contenttype.md) collection|Get a list of the [contentType](../resources/contenttype.md) objects and their properties in a [site](../resources/site.md).|
+|[List contentTypes in a list](../api/list-list-contenttypes.md)|[contentType](../resources/contenttype.md) collection|Get a list of the [contentType](../resources/contenttype.md) objects and their properties in a [list](../resources/list.md).|
+|[Create contentType for a site](../api/site-post-contenttypes.md)|[contentType](../resources/contenttype.md)|Create a new [contentType](../resources/contenttype.md) object in a [site](../resources/site.md).|
+|[Get contentType](../api/contenttype-get.md)|[contentType](../resources/contenttype.md)|Read the properties and relationships of a [contentType](../resources/contenttype.md) object.|
+|[Update contentType](../api/contenttype-update.md)|[contentType](../resources/contenttype.md)|Update the properties of a [contentType](../resources/contenttype.md) object.|
+|[Delete contentType](../api/contenttype-delete.md)|None|Deletes a [contentType](../resources/contenttype.md) object.|
+|[isPublished](../api/contenttype-ispublished.md)|Boolean| Checks if the [contentType](../resources/contenttype.md) is published.|
+|[publish](../api/contenttype-publish.md)|[contentType](../resources/contenttype.md)| Publish a [contentType](../resources/contenttype.md).|
+|[unpublish](../api/contenttype-unpublish.md)|[contentType](../resources/contenttype.md)|Unpublish a [contentType](../resources/contenttype.md).|
+|[addCopy](../api/contenttype-addcopy.md)|[contentType](../resources/contenttype.md)|Add copy of a [contentType](../resources/contenttype.md) from a [site](../resources/site.md) to a [list](../resources/list.md).|
+|[associateWithHubSites](../api/contenttype-associatewithhubsites.md)|[contentType](../resources/contenttype.md)|Associates a [contentType](../resources/contenttype.md) with a list of hub sites.|
+|[copyToDefaultContentLocation](../api/contenttype-copytodefaultcontentlocation.md)|[contentType](../resources/contenttype.md)| Copy a file to default content location in a [contentType](../resources/contenttype.md).|
+|[List columns](../api/contenttype-list-columns.md)|[columnDefinition](../resources/columnDefinition.md) collection|Get a collection of columns, represented as [columnDefinition](../resources/columnDefinition.md) resources, in a **contentType**.|
+|[Create column](../api/contenttype-post-columns.md)|[columnDefinition](../resources/columnDefinition.md)|Add a column to a **content type** in a site or list.|
++
+## Properties
+
+| Property name | Type | Description|
+|:|:|:-|
+| **description** | string | The descriptive text for the item.|
+| **group** | string | The name of the group this content type belongs to. Helps organize related content types.|
+| **hidden** | Boolean | Indicates whether the content type is hidden in the list's 'New' menu.|
+| **id** | string | The unique identifier of the content type.|
+| **inheritedFrom** | [itemReference][] | If this content type is inherited from another scope (like a site), provides a reference to the item where the content type is defined.|
+| **name** | string | The name of the content type.|
+| **order** | [contentTypeOrder][] | Specifies the order in which the content type appears in the selection UI.|
+| **parentId** | string | The unique identifier of the content type.|
+| **readOnly** | Boolean | If `true`, the content type can't be modified unless this value is first set to `false`.|
+| **sealed** | Boolean | If `true`, the content type can't be modified by users or through push-down operations. Only site collection administrators can seal or unseal content types.|
+| **isBuiltIn** | Boolean| Specifies if a content type is a built-in content type. |
+| **documentSet** | [documentSet][] | [Document Set](/sharepoint/governance/document-set-planning#about-document-sets) metadata.|
+| **documentTemplate** | [documentSetContent][] | Document template metadata. To make sure that documents have consistent content across a site and its subsites, you can associate a Word, Excel, or PowerPoint template with a site content type.|
+| **associatedHubsUrls** | Collection(string) | List of canonical URLs for hub sites with which this content type is associated to. This will contain all hub sites where this content type is queued to be enforced or is already enforced. Enforcing a content type means that the content type will be applied to the lists in the enforced sites.|
+| **propagateChanges** | Boolean | If `true`, any changes made to the content type will be pushed to inherited content types and lists that implement the content type.|
+++
+## Relationships
+
+| Property name | Type | Description|
+|:-|:--|:-|
+| **base** | [contentType][] | Parent contentType from which this content type is derived. |
+| **columnLinks** | [columnLink][] collection | The collection of columns that are required by this content type.|
+| **baseTypes** | Collection([contentType][]) | The collection of content types that are ancestors of this content type.|
+| **columnPositions** | Collection([columnDefinition][]) | Column order information in a content type.|
+| **columns** | Collection([columnDefinition][]) | The collection of column definitions for this contentType.|
+
+For more information, see [Introduction to content types and content type publishing][contentTypeIntro].
+
+[columnLink]: columnlink.md
+[contentTypeIntro]: https://support.office.com/en-us/article/Introduction-to-content-types-and-content-type-publishing-e1277a2e-a1e8-4473-9126-91a0647766e5
+[itemReference]: itemreference.md
+[contentTypeOrder]: contenttypeorder.md
+[columnDefinition]: columnDefinition.md
+[contentType]: contentType.md
+[documentSet]: documentSet.md
+[documentSetContent]: documentSetContent.md
## JSON representation
-Here is a JSON representation of a **contentType** resource.
-<!-- {
- "blockType": "resource",
- "baseType": "microsoft.graph.entity",
- "@odata.type": "microsoft.graph.contentType" } -->
+The following is a JSON representation of a **contentType** resource.
+
+<!-- { "blockType": "resource", "@odata.type": "microsoft.graph.contentType","keyProperty":"id" } -->
```json {
Here is a JSON representation of a **contentType** resource.
"parentId": "string", "readOnly": false, "sealed": false,-
- "columnLinks": [{ "@type": "microsoft.graph.columnLink" }]
+ "columnLinks": [{ "@type": "microsoft.graph.columnLink" }],
+ "base": { "@type": "microsoft.graph.contentType" },
+ "columnPositions" : [{ "@type": "microsoft.graph.columnDefinition" }],
+ "isBuiltIn" : false,
+ "documentSet" : { "@type": "microsoft.graph.documentSet" },
+ "documentTemplate" : { "@type": "microsoft.graph.documentSetContent" },
+ "associatedHubsUrls" : ["string"],
+ "propagateChanges" : false,
+ "baseTypes" : [{ "@type": "microsoft.graph.contentType" }],
+ "columns" : [{ "@type": "microsoft.graph.columnDefinition" }]
} ```
-## Properties
-
-| Property name | Type | Description
-|:|:|:-
-| **description** | string | The descriptive text for the item.
-| **group** | string | The name of the group this content type belongs to. Helps organize related content types.
-| **hidden** | boolean | Indicates whether the content type is hidden in the list's 'New' menu.
-| **id** | string | The unique identifier of the content type.
-| **inheritedFrom** | [itemReference][] | If this content type is inherited from another scope (like a site), provides a reference to the item where the content type is defined.
-| **name** | string | The name of the content type.
-| **order** | [contentTypeOrder][] | Specifies the order in which the content type appears in the selection UI.
-| **parentId** | string | The unique identifier of the content type.
-| **readOnly** | boolean | If `true`, the content type cannot be modified unless this value is first set to `false`.
-| **sealed** | boolean | If `true`, the content type cannot be modified by users or through push-down operations. Only site collection administrators can seal or unseal content types.
-
-## Relationships
-
-| Property name | Type | Description
-|:-|:--|:-
-| **columnLinks** | [columnLink][] collection | The collection of columns that are required by this content type
-
-See [Introduction to content types and content type publishing][contentTypeIntro] for more information.
-
-[columnLink]: columnlink.md
-[contentTypeIntro]: https://support.office.com/en-us/article/Introduction-to-content-types-and-content-type-publishing-e1277a2e-a1e8-4473-9126-91a0647766e5
-[itemReference]: itemreference.md
-[contentTypeOrder]: contenttypeorder.md
-
-<!-- {
+[list]: list.md
+[listItem]: listitem.md
+<!--
+{
"type": "#page.annotation", "description": "", "keywords": "", "section": "documentation",
- "tocPath": "Resources/ContentType"
-} -->
+ "tocPath": "Resources/ContentType",
+ "suppressions": []
+}
+-->
+
v1.0 Contentapprovalstatuscolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/contentapprovalstatuscolumn.md
++
+ Title: "contentApprovalStatusColumn resource type"
+description: "Indicates that the column contains information about the approval status of the item."
+localization_priority: Normal
++
+# contentApprovalStatusColumn resource type
+
+Namespace: microsoft.graph
+
+Represents a content approval status column in SharePoint.
+## Properties
+
+None.
+
+## JSON representation
+
+The following is a JSON representation of a **contentApprovalStatusColumn** resource.
+<!-- { "blockType": "resource", "@odata.type": "microsoft.graph.contentApprovalStatusColumn" } -->
+
+```json
+{
+}
+```
+
+[columnDefinition]: columnDefinition.md
v1.0 Directory https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/directory.md
Represents a deleted item in the directory. When an item is deleted, it is added
Currently, deleted items functionality is only supported for the [application](application.md), [group](group.md) and [user](user.md) resources.
+Inherits from [entity](entity.md).
+ ## Methods | Method | Return Type | Description |
Currently, deleted items functionality is only supported for the [application](a
|[Permanently delete an item](../api/directory-deleteditems-delete.md) | None | Permanently deletes an item. | |[List deleted items owned by a user](../api/directory-deleteditems-user-owned.md) | [directoryObject](directoryobject.md) collection | Lists directory items owned by a user. | +
+## Properties
+
+| Property | Type |Description|
+|:|:--|:-|
+|id|String| A unique identifier for the object; for example, `12345678-9abc-def0-1234-56789abcde`. Key. Not nullable. Read-only. Inherited from [entity](entity.md).|
++ ## Relationships+ | Relationship | Type |Description| |:|:--|:-|
+|administrativeUnits|[administrativeUnit](administrativeunit.md) collection| Conceptual container for user and group directory objects.|
|deletedItems|[directoryObject](directoryobject.md) collection| Recently deleted items. Read-only. Nullable.| ## JSON representation
-Here is a JSON representation of the resource.
+
+The following is a JSON representation of the resource.
<!-- { "blockType": "resource",
v1.0 Displaynamelocalization https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/displaynamelocalization.md
+
+ Title: "displayNameLocalization resource type"
+description: "Provides the ability for an administrator to customize the string used in a shared Microsoft 365 experience."
+localization_priority: Normal
+++
+# displayNameLocalization resource type
+
+Provides the ability for an administrator to customize the string used in a shared Microsoft 365 experience.
+
+## Properties
+
+| Property | Type | Description |
+|:-|:|:|
+|displayName |String | If present, the value of this field contains the **displayName** string that has been set for the language present in the **languageTag** field.|
+|languageTag |String | Provides the language culture-code and friendly name of the language that the **displayName** field has been provided in. |
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+
+ ],
+ "@odata.type": "microsoft.graph.displayNameLocalization",
+ "baseType": null
+}-->
+
+```json
+{
+ "displayName": "string",
+ "languageTag": "string"
+}
+```
+
+<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
+2019-02-04 14:57:30 UTC -->
+<!-- {
+ "type": "#page.annotation",
+ "description": "displayNameLocalization resource",
+ "keywords": "",
+ "section": "documentation",
+ "tocPath": ""
+}-->
++
v1.0 Documentset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/documentset.md
++
+ Title: "documentSet resource type"
+description: "Contains metadata about document set settings."
+localization_priority: Normal
++
+# documentSet resource type
+
+Namespace: microsoft.graph
+
+Represents a document set in SharePoint.
+
+## Properties
+
+| Property name | Type | Description|
+|:|:--|:--|
+| shouldPrefixNameToFile | Boolean | Add the name of the document set to each file name.|
+| allowedContentTypes | Collection(microsoft.graph.contentTypeInfo) | Content types allowed in document set.|
+| defaultContents | Collection(microsoft.graph.documentSetContent) | Default contents of document set. |
+| propagateWelcomePageChanges | Boolean | Specifies whether to push welcome page changes to inherited content types. |
+| sharedColumns | Collection(microsoft.graph.columnDefinition) | Columns edited on the document set that synchronize to all documents in the set. These are read-only on the documents themselves. |
+| welcomePageColumns | Collection(microsoft.graph.columnDefinition) | Specifies columns to show on the welcome page for the document set. |
+| welcomePageUrl | string | Welcome page absolute URL. |
+
+## JSON representation
+
+The following is a JSON representation of a **documentSet** resource.
+<!-- { "blockType": "resource", "@odata.type": "microsoft.graph.documentSet" } -->
+
+```json
+{
+ "shouldPrefixNameToFile": true,
+ "allowedContentTypes": [{ "@type": "microsoft.graph.contentTypeInfo" }],
+ "defaultContents": [{ "@type": "microsoft.graph.documentSetContent" }],
+ "propagateWelcomePageChanges": false,
+ "sharedColumns": [{ "@type": "microsoft.graph.columnDefinition" }],
+ "welcomePageColumns": [{ "@type": "microsoft.graph.columnDefinition" }],
+ "welcomePageUrl": "string"
+}
+```
+
+[contentTypeInfo]: contentTypeInfo.md
+[documentSetContent]: documentsetcontent.md
v1.0 Documentsetcontent https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/documentsetcontent.md
++
+ Title: "documentSetContent resource type"
+description: "The documentSetContent resource contains metadata about a file present in default content location of a content."
+localization_priority: Normal
++
+# documentSetContent resource type
+
+Namespace: microsoft.graph
+
+Represents the default content of document set in SharePoint.
+## Properties
+
+| Property name | Type | Description|
+|:|:--|:--|
+| contentType | microsoft.graph.contentTypeInfo | Content type information of the file. |
+| fileName | string | Name of the file in resource folder that should be added as a default content or a template in the document set.|
+| folderName | string | Folder name in which the file will be placed when a new document set is created in the library.|
+
+## JSON representation
+
+Here is a JSON representation of a **documentSetContent** resource.
+<!-- { "blockType": "resource", "@odata.type": "microsoft.graph.documentSetContent" } -->
+
+```json
+{
+ "contentType": { "@type": "microsoft.graph.contentTypeInfo" },
+ "fileName": "string",
+ "folderName": "string"
+}
+```
v1.0 Enums https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/enums.md
Possible values for user account types (group membership), per Windows definitio
| waitingOnOthers | deferred
+### columnTypes values
+
+|Member|Description|
+|:-|:
+|note| Multiline text. |
+|text | Single line text. |
+|choice | Choice column |
+|multichoice | Multichoice column. |
+|number | Number column. |
+|currency | Currency column. |
+|dateTime | DateTime column. |
+|lookup | Lookup column. |
+|boolean | Yes/No column. |
+|user | Person or group column. |
+|url | Hyperlink or picture column. |
+|calculated | Calculated column. |
+|location | Location column. |
+|geolocation | Geolocation column. |
+|term | Managed metadata column. |
+|multiterm | Managed metadata column accepting multiple values. |
+|thumbnail | Image column. |
+|approvalStatus | Content approval status column. |
+|unknownFutureValue | UnknownFuturevalue |
+ ### permissionClassificationType values | Member
v1.0 Hyperlinkorpicturecolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/hyperlinkorpicturecolumn.md
++
+ Title: "hyperlinkOrPictureColumn resource type"
+description: "The hyperlinkOrPictureColumn resource indicates that the column contains URL data which can be an achortag or an image that serves as a hyperlink."
+localization_priority: Normal
+
+# hyperlinkOrPictureColumn resource type
+
+Namespace: microsoft.graph
+
+Represents a hyperlink or picture column in SharePoint.
+
+## Properties
+
+| Property name | Type | Description|
+|:-|:-|:-|
+| isPicture | Boolean | Specifies whether the display format used for URL columns is an image or a hyperlink. |
++
+## JSON representation
+
+Here is a JSON representation of a **hyperlinkOrPictureColumn** resource.
+<!-- { "blockType": "resource", "@odata.type": "microsoft.graph.hyperlinkOrPictureColumn" } -->
+
+```json
+{
+ "isPicture": false
+}
+```
v1.0 Termcolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/termcolumn.md
++
+ Title: "termColumn resource type"
+description: "The termColumn resource indicates that the column's values contains taxonomy data."
+localization_priority: Normal
+
+# termColumn resource type
+
+Namespace: microsoft.graph
+
+Represents a managed metadata column in SharePoint.
+
+## Properties
+
+| Property name | Type | Description|
+|:--|:-|:-|
+| allowMultipleValues | Boolean | Specifies whether the column will allow more than one value.|
+| parentTerm | microsoft.graph.termStore.term | Specifies the term GUID whose children can be selected as column's value. |
+| showFullyQualifiedName | Boolean | Specifies whether to display the entire term path or only the term label. |
+| termSet | microsoft.graph.termStore.set | Termset whose children can be selected as column's value. |
+
+## JSON representation
+
+Here is a JSON representation of a **termColumn** resource.
+<!-- { "blockType": "resource", "@odata.type": "microsoft.graph.termColumn" } -->
+
+```json
+{
+ "allowMultipleValues": true,
+ "parentTerm": { "@type": "microsoft.graph.termStore.term" },
+ "showFullyQualifiedName": false,
+ "termSet": { "@type": "microsoft.graph.termStore.set" }
+}
+```
+
v1.0 Thumbnailcolumn https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/thumbnailcolumn.md
++
+ Title: "thumbnailColumn resource type"
+description: "The thumbnailColumn resource indicates that the column contains information about thumbnail."
+localization_priority: Normal
+
+# thumbnailColumn resource type
+
+Namespace: microsoft.graph
+The **thumbnailColumn** on a [columnDefinition](columnDefinition.md) resource indicates that the column contains information about thumbnail.
+
+## Properties
+
+The **thumbnailColumn** resource contains no properties.
+
+## JSON representation
+
+Here is a JSON representation of a **thumbnailColumn** resource.
+<!-- { "blockType": "resource", "@odata.type": "microsoft.graph.thumbnailColumn" } -->
+
+```json
+{
+}
+```
+
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
href: api/site-unfollow.md - name: List followed sites href: api/sites-list-followed.md
+ - name: List columns
+ href: api/site-list-columns.md
+ - name: Create column
+ href: api/site-post-columns.md
+ - name: List content types
+ href: api/site-list-contenttypes.md
+ - name: Create content type
+ href: api/site-post-contenttypes.md
+ - name: Get applicable content types for list
+ href: api/site-getapplicablecontenttypesforlist.md
+ - name: Get lists
+ href: api/list-list.md
+ - name: Create list
+ href: api/list-create.md
+ - name: List subsites
+ href: api/site-list-subsites.md
- name: Permissions href: resources/permission.md items:
items:
- name: Delete site permission href: api/site-delete-permission.md - name: Lists
- href: resources/list.md
items:
+ - name: List
+ href: resources/list.md
+ - name: Create list
+ href: api/list-create.md
- name: Get list href: api/list-get.md
+ - name: Get lists in a site
+ href: api/list-list.md
- name: Get items href: api/listitem-list.md
- - name: Create list
- href: api/list-create.md
+ - name: List columns
+ href: api/list-list-columns.md
+ - name: Create column
+ href: api/list-post-columns.md
+ - name: List content types
+ href: api/list-list-contenttypes.md
+ - name: Add copy of content type
+ href: api/contenttype-addcopy.md
+ - name: Columns
+ items:
+ - name: Column definition
+ href: resources/columndefinition.md
+ - name: Get
+ href: api/columndefinition-get.md
+ - name: Update
+ href: api/columndefinition-update.md
+ - name: Delete
+ href: api/columndefinition-delete.md
+ - name: Content types
+ items:
+ - name: Content type
+ href: resources/contentType.md
+ - name: Get
+ href: api/contenttype-get.md
+ - name: Update
+ href: api/contenttype-update.md
+ - name: Delete
+ href: api/contenttype-delete.md
+ - name: Check publishing status
+ href: api/contenttype-ispublished.md
+ - name: Publish
+ href: api/contenttype-publish.md
+ - name: Unpublish
+ href: api/contenttype-unpublish.md
+ - name: Add copy to list
+ href: api/contenttype-addcopy.md
+ - name: Associate with hub sites
+ href: api/contenttype-associatewithhubsites.md
+ - name: Copy to default content location
+ href: api/contenttype-copytodefaultcontentlocation.md
+ - name: List columns
+ href: api/contenttype-list-columns.md
+ - name: Create column
+ href: api/contenttype-post-columns.md
- name: List items href: resources/listitem.md items: