| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| v1.0 | Applicationtemplate Instantiate | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/applicationtemplate-instantiate.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -Add an instance of an application from the Azure AD application gallery into your directory. +Add an instance of an application from the Azure AD application gallery into your directory. You can also use this API to instantiate [non-gallery apps](/azure/active-directory/manage-apps/add-non-gallery-app). Use the following ID for the **applicationTemplate** object: `8adf8e6e-67b2-4cf2-a259-e3dc5476c621`. ## Permissions One of the following permissions is required to call this API. To learn more, in POST /applicationTemplates/{id}/instantiate ``` +To instantiate non-gallery apps, use the `8adf8e6e-67b2-4cf2-a259-e3dc5476c621` for the `{applicationTemplate-id}`. + ## Request headers | Name | Description | In the request body, provide a JSON object with the following parameters. ## Response -If successful, this method returns a `201 OK` response code and a new [applicationServicePrincipal](../resources/applicationserviceprincipal.md) object in the response body. +If successful, this method returns a `201 Created` response code and a new [applicationServicePrincipal](../resources/applicationserviceprincipal.md) object in the response body. ## Examples The following example shows how to call this API. ### Request -The following is an example of the request. - -> You can use this API to instantiate [non-gallery apps](/azure/active-directory/manage-apps/add-non-gallery-app). Use the following ID for **applicationTemplate**: `8adf8e6e-67b2-4cf2-a259-e3dc5476c621`. +The following is an example of the request. The request URL specifies `8adf8e6e-67b2-4cf2-a259-e3dc5476c621` as the application template ID. This means the request is instantiating a non-gallery app. # [HTTP](#tab/http) <!-- { The following is an example of the request. }--> ```http-POST https://graph.microsoft.com/beta/applicationTemplates/{id}/instantiate +POST https://graph.microsoft.com/beta/applicationTemplates/8adf8e6e-67b2-4cf2-a259-e3dc5476c621/instantiate Content-type: application/json {- "displayName": "My custom name" + "displayName": "testProperties" } ``` # [C#](#tab/csharp) The following is an example of the response. } --> ```http-HTTP/1.1 201 OK +HTTP/1.1 201 Created Content-type: application/json {- "servicePrincipal":{ - "accountEnabled":true, - "addIns":[ - { - "id":"id-value", - "type":"type-value", - "properties":[ - { - "key":"key-value", - "value":"value-value" - } - ] - } - ], - "appDisplayName":"appDisplayName-value", - "appId":"appId-value", - "appOwnerOrganizationId":"appOwnerOrganizationId-value", - "appRoleAssignmentRequired":true - }, - "application":{ - "api":{ - "acceptedAccessTokenVersion":1, - "publishedPermissionScopes":[ - { - "adminConsentDescription":"adminConsentDescription-value", - "adminConsentDisplayName":"adminConsentDisplayName-value", - "id":"id-value", - "isEnabled":true, - "type":"type-value", - "userConsentDescription":"userConsentDescription-value", - "userConsentDisplayName":"userConsentDisplayName-value", - "value":"value-value" - } - ] - }, - "allowPublicClient":true, - "applicationAliases":[ - "applicationAliases-value" - ], - "createdDateTime":"datetime-value", - "installedClients":{ - "redirectUrls":[ - "redirectUrls-value" - ] - } - } + "@odata.context": "https://graph.microsoft.com/beta/$metadata#microsoft.graph.applicationServicePrincipal", + "application": { + "objectId": "428fbcb1-35bc-471d-95f2-6cc339357cb5", + "appId": "23a223ba-bb90-4949-8232-1bf479189e9b", + "applicationTemplateId": "8adf8e6e-67b2-4cf2-a259-e3dc5476c621", + "displayName": "testProperties", + "homepage": "https://account.activedirectory.windowsazure.com:444/applications/default.aspx?metadata=customappsso|ISV9.1|primary|z", + "identifierUris": [], + "publicClient": null, + "replyUrls": [], + "logoutUrl": null, + "samlMetadataUrl": null, + "errorUrl": null, + "groupMembershipClaims": null, + "availableToOtherTenants": false + }, + "servicePrincipal": { + "objectId": "7b358fa1-7d10-4a57-bd96-b7e63c2f9be5", + "deletionTimestamp": null, + "accountEnabled": true, + "appId": "23a223ba-bb90-4949-8232-1bf479189e9b", + "appDisplayName": "testProperties", + "applicationTemplateId": "8adf8e6e-67b2-4cf2-a259-e3dc5476c621", + "appOwnerTenantId": "29a4f813-9274-4e1b-858d-0afa98ae66d4", + "appRoleAssignmentRequired": true, + "displayName": "testProperties", + "errorUrl": null, + "loginUrl": null, + "logoutUrl": null, + "homepage": "https://account.activedirectory.windowsazure.com:444/applications/default.aspx?metadata=customappsso|ISV9.1|primary|z", + "samlMetadataUrl": null, + "microsoftFirstParty": null, + "publisherName": "Contoso", + "preferredSingleSignOnMode": null, + "preferredTokenSigningKeyThumbprint": null, + "preferredTokenSigningKeyEndDateTime": null, + "replyUrls": [], + "servicePrincipalNames": [ + "23a223ba-bb90-4949-8232-1bf479189e9b" + ], + "tags": [ + "WindowsAzureActiveDirectoryIntegratedApp", + "WindowsAzureActiveDirectoryCustomSingleSignOnApplication" + ], + "notificationEmailAddresses": [], + "samlSingleSignOnSettings": null, + "keyCredentials": [], + "passwordCredentials": [] + } } ``` |
| v1.0 | Chatmessage Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/chatmessage-post.md | The following is an example of the request. "blockType": "request", "name": "post_chatmessage_3" }-->+ ```http POST https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages Content-type: application/json Content-type: application/json } ``` +### Example 10: Send message that contains cards that are attributed to a Teams app ++#### Request ++The following is an example of the request. ++> **Note:** When specifying a Teams app to attribute a card to, the Azure AD app ID used to make the call must match the Azure AD app ID of the Teams app. The Azure AD app ID of the Teams app can be specified in the *webApplicationInfo* section of the app's manifest. Refer to the following documentation on the current [Teams app manifest schema](/microsoftteams/platform/resources/schema/manifest-schema). +> +> Furthermore, the app specified in the payload must be installed either for the user sending the message or in the chat or channel in which the message is being sent. ++<!-- { + "blockType": "request", + "name": "post_chatmessage_10" +}--> ++```http +POST https://graph.microsoft.com/beta/teams/fbe2bf47-16c8-47cf-b4a5-4b9b187c508b/channels/19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2/messages +Content-type: application/json ++{ + "subject": null, + "body": { + "contentType": "html", + "content": "<attachment id=\"74d20c7f34aa4a7fb74e2b30004247c5\"></attachment>" + }, + "attachments": [ + { + "id": "74d20c7f34aa4a7fb74e2b30004247c5", + "contentType": "application/vnd.microsoft.card.thumbnail", + "contentUrl": null, + "content": "{\r\n \"title\": \"This is an example of posting a card\",\r\n \"subtitle\": \"<h3>This is the subtitle</h3>\",\r\n \"text\": \"Here is some body text. <br>\\r\\nAnd a <a href=\\\"http://microsoft.com/\\\">hyperlink</a>. <br>\\r\\nAnd below that is some buttons:\",\r\n \"buttons\": [\r\n {\r\n \"type\": \"messageBack\",\r\n \"title\": \"Login to FakeBot\",\r\n \"text\": \"login\",\r\n \"displayText\": \"login\",\r\n \"value\": \"login\"\r\n }\r\n ]\r\n}", + "name": null, + "thumbnailUrl": null, + "teamsAppId": "881b8843-fd91-49e5-9ac2-47ec497ffbe5" + } + ] +} +``` ++#### Response ++The following is an example of the response. +<!-- { + "blockType": "response", + "truncated": true, + "@odata.type": "microsoft.graph.chatMessage" +} --> ++```http +HTTP/1.1 201 Created +Content-type: application/json ++{ + "@odata.context": "https://graph.microsoft.com/beta/$metadata#teams('fbe2bf47-16c8-47cf-b4a5-4b9b187c508b')/channels('19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2')/messages/$entity", + "id": "1616991851162", + "replyToId": null, + "etag": "1616991851162", + "messageType": "message", + "createdDateTime": "2021-03-29T04:24:11.162Z", + "lastModifiedDateTime": "2021-03-29T04:24:11.162Z", + "lastEditedDateTime": null, + "deletedDateTime": null, + "subject": null, + "summary": null, + "chatId": null, + "importance": "normal", + "locale": "en-us", + "webUrl": "https://teams.microsoft.com/l/message/19%3A4a95f7d8db4c4e7fae857bcebe0623e6%40thread.tacv2/1616991851162?groupId=fbe2bf47-16c8-47cf-b4a5-4b9b187c508b&tenantId=2432b57b-0abd-43db-aa7b-16eadd115d34&createdTime=1616991851162&parentMessageId=1616991851162", + "policyViolation": null, + "eventDetail": null, + "from": { + "application": null, + "device": null, + "user": { + "id": "8ea0e38b-efb3-4757-924a-5f94061cf8c2", + "displayName": "Robin Kline", + "userIdentityType": "aadUser" + } + }, + "body": { + "contentType": "html", + "content": "<attachment id=\"74d20c7f34aa4a7fb74e2b30004247c5\"></attachment>" + }, + "channelIdentity": { + "teamId": "fbe2bf47-16c8-47cf-b4a5-4b9b187c508b", + "channelId": "19:4a95f7d8db4c4e7fae857bcebe0623e6@thread.tacv2" + }, + "attachments": [ + { + "id": "74d20c7f34aa4a7fb74e2b30004247c5", + "contentType": "application/vnd.microsoft.card.thumbnail", + "contentUrl": null, + "content": "{ \"title\": \"This is an example of posting a card\", \"subtitle\": \"<h3>This is the subtitle</h3>\", \"text\": \"Here is some body text. <br>\\\\And a <a href=\\\"http://microsoft.com/\\\">hyperlink</a>. <br>\\\\And below that is some buttons:\", \"buttons\": [ { \"type\": \"messageBack\", \"title\": \"Login to FakeBot\", \"text\": \"login\", \"displayText\": \"login\", \"value\": \"login\" } ]}", + "name": null, + "thumbnailUrl": null, + "teamsAppId": "881b8843-fd91-49e5-9ac2-47ec497ffbe5" + } + ], + "onBehalfOf": null, + "mentions": [], + "reactions": [] +} +``` + ## See also - [Cards reference](/microsoftteams/platform/concepts/cards/cards-reference) |
| v1.0 | Documentsetversion Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/documentsetversion-delete.md | + + Title: "Delete documentSetVersion" +description: "Delete a documentSetVersion object." ++ms.localizationpriority: medium +++# Delete documentSetVersion +Namespace: microsoft.graph +++Delete a [version of a document set](../resources/documentsetversion.md) 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). ++|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, Sites.Selected| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +DELETE /sites/{siteId}/lists/{listId}/items/{itemId}/documentSetVersions/{documentSetVersionId} +``` ++## 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 ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "delete_documentsetversion" +} +--> +``` http +DELETE https://graph.microsoft.com/beta/sites/root/lists/Documents/items/2/documentSetVersions/1 +``` +++### Response ++The following is an example of the response. ++<!-- { + "blockType": "response", + "name": "delete_documentsetversion", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
| v1.0 | Documentsetversion Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/documentsetversion-get.md | + + Title: "Get documentSetVersion" +description: "Read the properties and relationships of a documentSetVersion object." ++ms.localizationpriority: medium +++# Get documentSetVersion +Namespace: microsoft.graph +++Read the properties and relationships of a [documentSetVersion](../resources/documentsetversion.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)| 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, Sites.Selected| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{siteId}/lists/{listId}/items/{itemId}/documentSetVersions/{documentSetVersionId} +``` ++## 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 [documentSetVersion](../resources/documentsetversion.md) object in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "get_documentsetversion" +} +--> +``` http +GET https://graph.microsoft.com/beta/sites/root/lists/Documents/items/2/documentSetVersions/1 +``` +++### Response ++The following is an example of the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "name": "get_documentsetversion", + "truncated": true, + "@odata.type": "microsoft.graph.documentSetVersion" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "1", + "lastModifiedDateTime": "2022-04-05T04:53:42Z", + "comment": "v1", + "createdDateTime": "2022-04-05T04:53:42Z", + "shouldCaptureMinorVersion": false, + "lastModifiedBy": { + "user": { + "displayName": "Tenant Admin User", + "email": "admin@contoso.sharepoint.com" + } + }, + "items": [ + { + "itemId": "a5d83ae7-8c3e-4a2c-bc3e-8f276db857bf", + "versionId": "1.0" + } + ], + "createdBy": { + "user": { + "displayName": "Tenant Admin User", + "email": "admin@contoso.sharepoint.com" + } + } +} +``` + |
| v1.0 | Documentsetversion Restore | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/documentsetversion-restore.md | + + Title: "documentSetVersion: restore" +description: "Restore a documentSetVersion." ++ms.localizationpriority: medium +++# documentSetVersion: restore +Namespace: microsoft.graph +++Restore a [document set version](../resources/documentsetversion.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)|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, Sites.Selected| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /sites/{siteId}/lists/{listId}/items/{itemId}/documentSetVersions/{documentSetVersionId}/restore +``` ++## Request headers +|Name|Description| +|:|:| +|Authorization|Bearer {token}. Required.| ++## Request body +Do not supply a request body for this method. ++## Response ++If successful, this action returns a `204 No Content` response code. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "documentsetversionthis.restore" +} +--> +``` http +POST https://graph.microsoft.com/beta/sites/root/lists/Documents/items/2/documentSetVersions/1/restore +``` +++### Response ++The following is an example of the response. ++<!-- { + "blockType": "response", + "name": "documentsetversionthis.restore", + "truncated": true +} +--> +``` http +HTTP/1.1 204 No Content +``` + |
| v1.0 | Group Post Threads | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-post-threads.md | The following is an example of the response. } --> ```http-HTTP/1.1 201 OK +HTTP/1.1 201 Created Content-type: application/json { |
| v1.0 | Invitation Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/invitation-post.md | The following is an example of the response. "@odata.type": "microsoft.graph.invitation" } --> ```http-HTTP/1.1 201 OK +HTTP/1.1 201 Created Content-type: application/json { |
| v1.0 | Listitem List Documentsetversions | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/listitem-list-documentsetversions.md | + + Title: "List documentSetVersions" +description: "Get a list of the versions of a document set item in a list." ++ms.localizationpriority: medium +++# List documentSetVersions +Namespace: microsoft.graph +++Get a list of the [versions of a document set](../resources/documentsetversion.md) item in a [list](../resources/list.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)| 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, Sites.Selected| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{siteId}/lists/{listId}/items/{itemId}/documentSetVersions +``` ++## 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 [documentSetVersion](../resources/documentsetversion.md) objects in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "list_documentsetversion" +} +--> +``` http +GET https://graph.microsoft.com/beta/sites/root/lists/Documents/items/1/documentSetVersions +``` +++### Response ++The following is an example of the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "name": "list_documentsetversion", + "truncated": true, + "@odata.type": "microsoft.graph.documentSetVersion", + "isCollection": true +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "id": "2", + "lastModifiedDateTime": "2022-04-05T04:55:29Z", + "comment": "v2", + "createdDateTime": "2022-04-05T04:55:29Z", + "shouldCaptureMinorVersion": false, + "lastModifiedBy": { + "user": { + "displayName": "Tenant Admin User", + "email": "admin@contoso.sharepoint.com" + } + }, + "items": [ + { + "itemId": "a5d83ae7-8c3e-4a2c-bc3e-8f276db857bf", + "versionId": "1.0" + }, + { + "itemId": "62d40672-befe-4017-934b-06372fd96022", + "versionId": "1.0" + } + ], + "createdBy": { + "user": { + "displayName": "Tenant Admin User", + "email": "admin@contoso.sharepoint.com" + } + } + }, + { + "id": "1", + "lastModifiedDateTime": "2022-04-05T04:53:42Z", + "comment": "v1", + "createdDateTime": "2022-04-05T04:53:42Z", + "shouldCaptureMinorVersion": false, + "lastModifiedBy": { + "user": { + "displayName": "Tenant Admin User", + "email": "admin@contoso.sharepoint.com" + } + }, + "items": [ + { + "itemId": "a5d83ae7-8c3e-4a2c-bc3e-8f276db857bf", + "versionId": "1.0" + } + ], + "createdBy": { + "user": { + "displayName": "Tenant Admin User", + "email": "admin@contoso.sharepoint.com" + } + } + } + ] +} +``` + |
| v1.0 | Listitem Post Documentsetversions | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/listitem-post-documentsetversions.md | + + Title: "Create documentSetVersion" +description: "Create a new version of a document set item in a list." ++ms.localizationpriority: medium +++# Create documentSetVersion +Namespace: microsoft.graph +++Create a new [version of a document set](../resources/documentsetversion.md) item in a [list](../resources/list.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)|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, Sites.Selected| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +POST /sites/{siteId}/lists/{listId}/items/{itemId}/documentSetVersions +``` ++## 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 [documentSetVersion](../resources/documentsetversion.md) object. ++You can specify the following properties when you create a **documentSetVersion**. ++|Property|Type|Description| +|:|:|:| +|comment|String|Comment about the captured version. Optional.| +|shouldCaptureMinorVersion|Boolean|If `true`, minor versions of items are also captured; otherwise, only major versions will be captured. Optional.| ++++## Response ++If successful, this method returns a `201 Created` response code and a [documentSetVersion](../resources/documentsetversion.md) object in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "create_documentsetversion" +} +--> +``` http +POST https://graph.microsoft.com/beta/sites/root/lists/Documents/items/2/documentSetVersions +Content-Type: application/json +Content-length: 70 ++{ + "comment": "v1", + "shouldCaptureMinorVersion": false +} +``` +++### Response ++The following is an example of the response. ++>**Note:** The response object shown here might be shortened for readability. +<!-- { + "blockType": "response", + "name": "create_documentsetversion", + "truncated": true, + "@odata.type": "microsoft.graph.documentSetVersion" +} +--> +``` http +HTTP/1.1 201 Created +Content-Type: application/json ++{ + "id": "1", + "lastModifiedDateTime": "2022-04-05T04:53:42Z", + "comment": "v1", + "createdDateTime": "2022-04-05T04:53:42Z", + "shouldCaptureMinorVersion": false, + "lastModifiedBy": { + "user": { + "displayName": "Tenant Admin User", + "email": "admin@contoso.sharepoint.com" + } + }, + "items": [ + { + "itemId": "a5d83ae7-8c3e-4a2c-bc3e-8f276db857bf", + "versionId": "1.0" + } + ], + "createdBy": { + "user": { + "displayName": "Tenant Admin User", + "email": "admin@contoso.sharepoint.com" + } + } +} +``` + |
| v1.0 | Oauth2permissiongrant Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/oauth2permissiongrant-delete.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.ReadWrite.All | +|Application | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request |
| v1.0 | Oauth2permissiongrant Delta | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/oauth2permissiongrant-delta.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|oauth2permissiongrant | Directory.Read.All, Directory.ReadWrite.All | +|oauth2permissiongrant | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request |
| v1.0 | Oauth2permissiongrant Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/oauth2permissiongrant-get.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.Read.All, Directory.ReadWrite.All | +|Application | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request |
| v1.0 | Oauth2permissiongrant List | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/oauth2permissiongrant-list.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.Read.All, Directory.ReadWrite.All | +|Application | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request |
| v1.0 | Oauth2permissiongrant Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/oauth2permissiongrant-post.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.ReadWrite.All | +|Application | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request |
| v1.0 | Oauth2permissiongrant Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/oauth2permissiongrant-update.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.ReadWrite.All | +|Application | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request <!-- { "blockType": "ignored" } --> |
| v1.0 | Chatmessageattachment | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/chatmessageattachment.md | An entity of type `chatMessageAttachment` is returned as part of the [Get channe |contentUrl|string|URL for the content of the attachment. Supported protocols: http, https, file and data.| |content|string|The content of the attachment. If the attachment is a [rich card](/microsoftteams/platform/task-modules-and-cards/cards/cards-reference), set the property to the rich card object. This property and contentUrl are mutually exclusive.| |name|string|Name of the attachment.|+|teamsAppId| string |The ID of the Teams app that is associated with the attachment. The property is specifically used to attribute a Teams message card to the specified app.| |thumbnailUrl| string |URL to a thumbnail image that the channel can use if it supports using an alternative, smaller form of content or contentUrl. For example, if you set contentType to application/word and set contentUrl to the location of the Word document, you might include a thumbnail image that represents the document. The channel could display the thumbnail image instead of the document. When the user clicks the image, the channel would open the document.| + ## JSON representation The following is a JSON representation of the resource An entity of type `chatMessageAttachment` is returned as part of the [Get channe "optionalProperties": [ "thumbnailUrl", "content",- "contentUrl" + "contentUrl", + "teamsAppId" ], "keyProperty": "id", "@odata.type": "microsoft.graph.chatMessageAttachment" An entity of type `chatMessageAttachment` is returned as part of the [Get channe "contentUrl": "string", "content": "string", "name": "string",+ "teamsAppId": "string", "thumbnailUrl": "string" } |
| v1.0 | Documentsetversion | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/documentsetversion.md | + + Title: "documentSetVersion resource type" +description: "Represents the version of a document set item in a list." ++ms.localizationpriority: medium +++# documentSetVersion resource type ++Namespace: microsoft.graph +++Represents the version of a document set item in a list. ++Inherits from [listItemVersion](../resources/listitemversion.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[List documentSetVersions](../api/listitem-list-documentsetversions.md)|[documentSetVersion](../resources/documentsetversion.md) collection|Get the [documentSetVersion](../resources/documentsetversion.md) resources from the **documentSetVersions** navigation property.| +|[Create documentSetVersion](../api/listitem-post-documentsetversions.md)|[documentSetVersion](../resources/documentsetversion.md)|Create a new [documentSetVersion](../resources/documentsetversion.md) object.| +|[Get documentSetVersion](../api/documentsetversion-get.md)|[documentSetVersion](../resources/documentsetversion.md)|Read the properties and relationships of a [documentSetVersion](../resources/documentsetversion.md) object.| +|[Delete documentSetVersion](../api/documentsetversion-delete.md)|None|Delete a [documentSetVersion](../resources/documentsetversion.md) object.| +|[restore](../api/documentsetversion-restore.md)|[documentSetVersion](../resources/documentsetversion.md)|Restore a [documentSetVersion](../resources/documentsetversion.md).| +++## Properties +|Property|Type|Description| +|:|:|:| +| comment | string | Comment about the captured version.| +| createdBy | [identitySet](../resources/identityset.md) | User who captured the version.| +| createdDateTime | dateTime | Date and time when this version was created.| +| id | string | The ID of the version. Read-only. Inherited from [listItemVersion](../resources/listitemversion.md).| +| items | [documentSetVersionItem](../resources/documentsetversionitem.md) collection | Items within the document set that are captured as part of this version.| +| lastModifiedBy | [identitySet](../resources/identityset.md) | Identity of the user which last modified the version. Read-only. Inherited from [listItemVersion](../resources/listitemversion.md).| +| lastModifiedDateTime | [dateTimeOffset](../resources/timestamp.md) | Date and time when the version was last modified. Read-only. Inherited from [listItemVersion](../resources/listitemversion.md). | +| published | [publicationFacet](../resources/publicationfacet.md) | Indicates the publication status of this particular version. Read-only. Inherited from [listItemVersion](../resources/listitemversion.md).| +| shouldCaptureMinorVersion | boolean | If `true`, minor versions of items are also captured; otherwise, only major versions will be captured. Default value is `false`.| ++## Relationships +|Relationship|Type|Description| +|:|:|:| +| fields | [fieldValueSet](../resources/fieldvalueset.md) | A collection of the fields and values for this version of the list item. | ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.documentSetVersion", + "baseType": "microsoft.graph.listItemVersion", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.documentSetVersion", + "comment": "String", + "createdDateTime": "String (timestamp)", + "createdBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "id": "String (identifier)", + "items": [ + { + "@odata.type": "microsoft.graph.documentSetVersionItem" + } + ], + "lastModifiedBy": { + "@odata.type": "microsoft.graph.identitySet" + }, + "lastModifiedDateTime": "String (timestamp)", + "publication": { + "@odata.type": "microsoft.graph.publicationFacet" + }, + "shouldCaptureMinorVersion": "Boolean" +} +``` + |
| v1.0 | Documentsetversionitem | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/documentsetversionitem.md | + + Title: "documentSetVersionItem resource type" +description: "Represents an item which is a part of a captured document set version." ++ms.localizationpriority: medium +++# documentSetVersionItem resource type ++Namespace: microsoft.graph +++Represents an [item](../resources/listitem.md) which is a part of a captured [documentSetVersion](../resources/documentsetversion.md). ++## Properties +|Property|Type|Description| +|:|:|:| +|itemId|String| The unique identifier for the item. | +|title|String| The title of the item. | +|versionId|String| The version ID of the item.| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "@odata.type": "microsoft.graph.documentSetVersionItem" +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.documentSetVersionItem", + "itemId": "String", + "title": "String", + "versionId": "String" +} +``` + |
| v1.0 | Domain | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/domain.md | To associate a domain with a tenant: |:|:--|:-| |[Get domain](../api/domain-get.md) | [domain](domain.md) | Read properties and relationships of a domain object.| |[Create domain](../api/domain-post-domains.md) | [domain](domain.md) | Adds a domain to the tenant. |+|[List domain](../api/domain-list.md) | [domain](domain.md) | Retrieve all domains linked to the tenant. | |[List domainNameReference](../api/domain-list-domainnamereferences.md) |[directoryObject](directoryobject.md) collection| Retrieve a list of directory objects with a reference to the domain.| |[List serviceConfigurationRecords](../api/domain-list-serviceconfigurationrecords.md) |[domainDnsRecord](domaindnsrecord.md) collection| Retrieve a list of domain DNS records for domain configuration.| |[List verificationDnsRecords](../api/domain-list-verificationdnsrecords.md) |[domainDnsRecord](domaindnsrecord.md) collection| Retrieve a list of domain DNS records for domain verification.| |
| v1.0 | Groups Overview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/groups-overview.md | The power of Microsoft 365 groups is in its collaborative nature, perfect for pe The following JSON object shows a sample representation of a group when you call the Microsoft Graph groups API. ```http-HTTP/1.1 201 OK +HTTP/1.1 201 Created Content-type: application/json { To learn more about Microsoft 365 groups and the administrator experiences, see The following JSON object shows a sample representation of a group when you call the Microsoft Graph groups API. ```http-HTTP/1.1 201 OK +HTTP/1.1 201 Created Content-type: application/json { |
| v1.0 | Listitem | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/listitem.md | - -description: This resource represents an item in a SharePoint list. Previously updated : 09/11/2017 Title: ListItem++description: "This resource represents an item in a SharePoint list." + Title: "listItem resource" ms.localizationpriority: medium ms.prod: sharepoint doc_type: resourcePageType -# ListItem resource +# listItem resource Namespace: microsoft.graph All examples below are relative to a **[list][]**, eg: `https://graph.microsoft. | [Update][] | PATCH /items/{item-id} | | [Update column values][Update] | PATCH /items/{item-id}/fields | | [createLink][CreateLink] | POST /items/{itemId}/createLink |+|[List documentSetVersions](../api/listitem-list-documentsetversions.md)| GET /items/{item-id}/documentSetVersions | +|[Create documentSetVersion](../api/listitem-post-documentsetversions.md)| POST /items/{item-id}/documentSetVersions | +|[Restore documentSetVersion](../api/documentsetversion-restore.md)| POST /items/{item-id}/documentSetVersions/{documentSetVersion-id}/restore | [Get]: ../api/listitem-get.md [Get analytics]: ../api/itemanalytics-get.md Here is a JSON representation of a **listItem** resource. /* relationships */ "activities": [{"@odata.type": "microsoft.graph.itemActivity"}], "analytics": { "@odata.type": "microsoft.graph.itemAnalytics" },+ "documentSetVersions": [{"@odata.type": "microsoft.graph.documentSetVersion"}], "driveItem": { "@odata.type": "microsoft.graph.driveItem" }, "versions": [{"@odata.type": "microsoft.graph.listItemVersion"}], The following properties are inherited from **[baseItem][]**. | Relationship | Type | Description | | :-- | :-- | :- | | activities | [itemActivity][] collection | The list of recent activities that took place on this item. |-| analytics | [itemAnalytics][] resource | Analytics about the view activities that took place on this item. | +| analytics | [itemAnalytics][] resource | Analytics about the view activities that took place on this item.| +|documentSetVersions|[documentSetVersion](../resources/documentsetversion.md) collection| Version information for a document set version created by a user.| | driveItem | [driveItem][] | For document libraries, the **driveItem** relationship exposes the listItem as a **[driveItem][]** | | fields | [fieldValueSet][] | The values of the columns set on this list item. | | versions | [listItemVersion][] collection | The list of previous versions of the list item. | |
| v1.0 | Applicationtemplate Instantiate | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/applicationtemplate-instantiate.md | doc_type: 'apiPageType' Namespace: microsoft.graph -Add an instance of an application from the Azure AD application gallery into your directory. +Add an instance of an application from the Azure AD application gallery into your directory. You can also use this API to instantiate [non-gallery apps](/azure/active-directory/manage-apps/add-non-gallery-app). Use the following ID for the **applicationTemplate** object: `8adf8e6e-67b2-4cf2-a259-e3dc5476c621`. ## Permissions One of the following permissions is required to call this API. To learn more, in <!-- { "blockType": "ignored" } --> ```http-POST /applicationTemplates/{id}/instantiate +POST /applicationTemplates/{applicationTemplate-id}/instantiate ``` +To instantiate non-gallery apps, use the `8adf8e6e-67b2-4cf2-a259-e3dc5476c621` for the `{applicationTemplate-id}`. + ## Request headers | Name | Description | In the request body, provide a JSON object with the following parameters. ## Response -If successful, this method returns a `201 OK` response code and a new [applicationServicePrincipal](../resources/applicationserviceprincipal.md) object in the response body. +If successful, this method returns a `201 Created` response code and a new [applicationServicePrincipal](../resources/applicationserviceprincipal.md) object in the response body. ## Examples The following example shows how to call this API. The following is an example of the request. -> You can use this API to instantiate [non-gallery apps](/azure/active-directory/manage-apps/add-non-gallery-app). Use the following ID for **applicationTemplate**: `8adf8e6e-67b2-4cf2-a259-e3dc5476c621`. - # [HTTP](#tab/http) <!-- { The following is an example of the request. }--> ```http-POST https://graph.microsoft.com/v1.0/applicationTemplates/{id}/instantiate +POST https://graph.microsoft.com/v1.0/applicationTemplates/229946b9-a9fb-45b8-9531-efa47453ac9e/instantiate Content-type: application/json {- "displayName": "My custom name" + "displayName": "Azure AD SAML Toolkit" } ``` # [C#](#tab/csharp) The following is an example of the response. } --> ```http-HTTP/1.1 201 OK +HTTP/1.1 201 Created Content-type: application/json {- "servicePrincipal":{ - "accountEnabled":true, - "addIns":[], - "alternativeNames":[ - "http://contoso/a7770d29-4321-41a6-b863-ca11d6639448" - ], - "appDisplayName":"appDisplayName-value", - "appId":"appId-value", - "appOwnerOrganizationId":"appOwnerOrganizationId-value", - "appRoleAssignmentRequired":true, - "appRoles":[], - "displayName":"Display name", - "endpoints":[], - "homepage":null, - "id":"id-value", - "info":{ - "termsOfServiceUrl":null, - "supportUrl":null, - "privacyStatementUrl":null, - "marketingUrl":null, - "logoUrl":null - }, - "keyCredentials":[], - "logoutUrl":null, - "oauth2PermissionScopes":[], - "passwordCredentials":[], - "publisherName":null, - "replyUrls":[], - "servicePrincipalNames":[], - "servicePrincipalType":null, - "tags":[], - "tokenEncryptionKeyId":null - }, - "application":{ - "id":"id-value", - "isFallbackPublicClient":null, - "appId":"appId-value", - "applicationTemplateId":null, - "identifierUris":[], - "createdDateTime":"2019-09-17T19:10:35.2742618Z", - "displayName":"Display name", - "isDeviceOnlyAuthSupported":null, - "groupMembershipClaims":null, - "optionalClaims":null, - "addIns":[], - "publisherDomain":"contoso.onmicrosoft.com", - "signInAudience":"AzureADMyOrg", - "tags":[], - "tokenEncryptionKeyId":null, - "api":{ - "requestedAccessTokenVersion":2, - "acceptMappedClaims":null, - "knownClientApplications":[], - "oauth2PermissionScopes":[], - "preAuthorizedApplications":[] - }, - "appRoles":[], - "publicClient":{ - "redirectUris":[] - }, - "info":{ - "termsOfServiceUrl":null, - "supportUrl":null, - "privacyStatementUrl":null, - "marketingUrl":null, - "logoUrl":null - }, - "keyCredentials":[], - "parentalControlSettings":{ - "countriesBlockedForMinors":[], - "legalAgeGroupRule":"Allow" - }, - "passwordCredentials":[], - "requiredResourceAccess":[ ], - "web":{ - "redirectUris":[], - "homePageUrl":null, - "logoutUrl":null, - "implicitGrantSettings":{ - "enableIdTokenIssuance":false, - "enableAccessTokenIssuance":false - } - } - } + "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#microsoft.graph.applicationServicePrincipal", + "application": { + "id": "20845737-a145-446f-aa3c-77d432903957", + "appId": "3c653ec4-4e4c-4820-8127-49e3889cad99", + "applicationTemplateId": "229946b9-a9fb-45b8-9531-efa47453ac9e", + "createdDateTime": "2022-04-25T16:48:24Z", + "deletedDateTime": null, + "displayName": "Azure AD SAML Toolkit", + "groupMembershipClaims": null, + "identifierUris": [], + "isFallbackPublicClient": false, + "signInAudience": "AzureADMyOrg", + "tags": [], + "tokenEncryptionKeyId": null, + "defaultRedirectUri": null, + "optionalClaims": null, + "addIns": [], + "api": { + "acceptMappedClaims": null, + "knownClientApplications": [], + "requestedAccessTokenVersion": null, + "oauth2PermissionScopes": [ + { + "adminConsentDescription": "Allow the application to access Azure AD SAML Toolkit on behalf of the signed-in user.", + "adminConsentDisplayName": "Access Azure AD SAML Toolkit", + "id": "00e7ef81-4deb-41d7-9ee3-90d4eba1e991", + "isEnabled": true, + "type": "User", + "userConsentDescription": "Allow the application to access Azure AD SAML Toolkit on your behalf.", + "userConsentDisplayName": "Access Azure AD SAML Toolkit", + "value": "user_impersonation" + } + ], + "preAuthorizedApplications": [] + }, + "appRoles": [ + { + "allowedMemberTypes": [ + "User" + ], + "displayName": "msiam_access", + "id": "8b292bda-39b6-4b77-849e-887565235bb0", + "isEnabled": true, + "description": "msiam_access", + "value": null, + "origin": "Application" + } + ], + "info": { + "logoUrl": null, + "marketingUrl": null, + "privacyStatementUrl": null, + "supportUrl": null, + "termsOfServiceUrl": null + }, + "keyCredentials": [], + "parentalControlSettings": { + "countriesBlockedForMinors": [], + "legalAgeGroupRule": "Allow" + }, + "passwordCredentials": [], + "publicClient": { + "redirectUris": [] + }, + "requiredResourceAccess": [], + "verifiedPublisher": { + "displayName": null, + "verifiedPublisherId": null, + "addedDateTime": null + }, + "web": { + "homePageUrl": "https://samltoolkit.azurewebsites.net/SAML/Consume?metadata=samltoolkit|ISV9.2|primary|z", + "redirectUris": [ + "https://samltoolkit.azurewebsites.net/SAML/Consume" + ] + } + }, + "servicePrincipal": { + "id": "912729dd-97ae-4ceb-ade4-07bed3046486", + "deletedDateTime": null, + "accountEnabled": true, + "appId": "3c653ec4-4e4c-4820-8127-49e3889cad99", + "applicationTemplateId": "229946b9-a9fb-45b8-9531-efa47453ac9e", + "appDisplayName": "Azure AD SAML Toolkit", + "alternativeNames": [], + "appOwnerOrganizationId": "29a4f813-9274-4e1b-858d-0afa98ae66d4", + "displayName": "Azure AD SAML Toolkit", + "appRoleAssignmentRequired": true, + "loginUrl": null, + "logoutUrl": null, + "homepage": "https://samltoolkit.azurewebsites.net/SAML/Consume?metadata=samltoolkit|ISV9.2|primary|z", + "notificationEmailAddresses": [], + "preferredSingleSignOnMode": null, + "preferredTokenSigningKeyThumbprint": null, + "replyUrls": [ + "https://samltoolkit.azurewebsites.net/SAML/Consume" + ], + "servicePrincipalNames": [ + "3c653ec4-4e4c-4820-8127-49e3889cad99" + ], + "servicePrincipalType": "Application", + "tags": [ + "WindowsAzureActiveDirectoryIntegratedApp" + ], + "tokenEncryptionKeyId": null, + "samlSingleSignOnSettings": null, + "verifiedPublisher": { + "displayName": null, + "verifiedPublisherId": null, + "addedDateTime": null + }, + "addIns": [], + "appRoles": [ + { + "allowedMemberTypes": [ + "User" + ], + "displayName": "msiam_access", + "id": "8b292bda-39b6-4b77-849e-887565235bb0", + "isEnabled": true, + "description": "msiam_access", + "value": null, + "origin": "Application" + } + ], + "info": { + "logoUrl": null, + "marketingUrl": null, + "privacyStatementUrl": null, + "supportUrl": null, + "termsOfServiceUrl": null + }, + "keyCredentials": [], + "oauth2PermissionScopes": [ + { + "adminConsentDescription": "Allow the application to access Azure AD SAML Toolkit on behalf of the signed-in user.", + "adminConsentDisplayName": "Access Azure AD SAML Toolkit", + "id": "00e7ef81-4deb-41d7-9ee3-90d4eba1e991", + "isEnabled": true, + "type": "User", + "userConsentDescription": "Allow the application to access Azure AD SAML Toolkit on your behalf.", + "userConsentDisplayName": "Access Azure AD SAML Toolkit", + "value": "user_impersonation" + } + ], + "passwordCredentials": [] + } } ``` |
| v1.0 | Group Post Threads | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-post-threads.md | The following is an example of the response. } --> ```http-HTTP/1.1 201 OK +HTTP/1.1 201 Created Content-type: application/json { |
| v1.0 | Invitation Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/invitation-post.md | The following is an example of the response. "@odata.type": "microsoft.graph.invitation" } --> ```http-HTTP/1.1 201 OK +HTTP/1.1 201 Created Content-type: application/json { |
| v1.0 | Oauth2permissiongrant Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/oauth2permissiongrant-delete.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.ReadWrite.All | +|Application | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request |
| v1.0 | Oauth2permissiongrant Delta | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/oauth2permissiongrant-delta.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | Directory.Read.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.Read.All, Directory.ReadWrite.All | +|Application | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request |
| v1.0 | Oauth2permissiongrant Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/oauth2permissiongrant-get.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.Read.All, Directory.ReadWrite.All | +|Application | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request |
| v1.0 | Oauth2permissiongrant List | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/oauth2permissiongrant-list.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.Read.All, Directory.ReadWrite.All | +|Application | Directory.Read.All, DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request |
| v1.0 | Oauth2permissiongrant Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/oauth2permissiongrant-post.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.ReadWrite.All | +|Application | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request |
| v1.0 | Oauth2permissiongrant Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/oauth2permissiongrant-update.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Directory.ReadWrite.All | +|Application | DelegatedPermissionGrant.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request <!-- { "blockType": "ignored" } --> |
| v1.0 | Domain | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/domain.md | To associate a domain with a tenant: |:|:--|:-| |[Get domain](../api/domain-get.md) | [domain](domain.md) | Read properties and relationships of a domain object.| |[Create domain](../api/domain-post-domains.md) | [domain](domain.md) | Adds a domain to the tenant. |+|[List domain](../api/domain-list.md) | [domain](domain.md) | Retrieve all domains linked to the tenant. | |[List domainNameReference](../api/domain-list-domainnamereferences.md) |[directoryObject](directoryobject.md) collection| Retrieve a list of directory objects with a reference to the domain.| |[List serviceConfigurationRecords](../api/domain-list-serviceconfigurationrecords.md) |[domainDnsRecord](domaindnsrecord.md) collection| Retrieve a list of domain DNS records for domain configuration.| |[List verificationDnsRecords](../api/domain-list-verificationdnsrecords.md) |[domainDnsRecord](domaindnsrecord.md) collection| Retrieve a list of domain DNS records for domain verification.| |
| v1.0 | Groups Overview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/groups-overview.md | The power of Microsoft 365 groups is in its collaborative nature, perfect for pe The following JSON object shows a sample representation of a group when you call the Microsoft Graph groups API. ```http-HTTP/1.1 201 OK +HTTP/1.1 201 Created Content-type: application/json { To learn more about Microsoft 365 groups and the administrator experiences, see The following JSON object shows a sample representation of a group when you call the Microsoft Graph groups API. ```http-HTTP/1.1 201 OK +HTTP/1.1 201 Created Content-type: application/json { |
| v1.0 | Toc.Yml | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/toc.yml | a/api-reference/v1.0/toc.yml items: items: - name: List domains href: api/domain-list.md+ - name: List domain name references + href: api/domain-list-domainnamereferences.md + - name: List service configuration records + href: api/domain-list-serviceconfigurationrecords.md + - name: List verification DNS records + href: api/domain-list-verificationdnsrecords.md - name: Create domain href: api/domain-post-domains.md - name: Delete domain |