| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| v1.0 | Application Post Calls | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-post-calls.md | The following example shows a request that makes a peer-to-peer call between the <!-- { "blockType": "request", "name": "create-call-service-hosted-media-1",- "@odata.type": "microsoft.graph.call" + "@odata.type": "microsoft.graph.call", + "truncated": true }--> ```http The following example shows a request that makes a peer-to-peer call between the <!-- { "blockType": "request", "name": "create-call-app-hosted-media",- "@odata.type": "microsoft.graph.call" + "@odata.type": "microsoft.graph.call", + "truncated": true }--> ```http Content-Type: application/json <!-- { "blockType": "example",- "@odata.type": "microsoft.graph.call" + "@odata.type": "microsoft.graph.call", + "truncated": true }--> ```json Content-Type: application/json <!-- { "blockType": "example",- "@odata.type": "microsoft.graph.call" + "@odata.type": "microsoft.graph.call", + "truncated": true }--> ```json The following example shows the request to make a peer-to-peer call between the <!-- { "blockType": "request", "name": "create-call-service-hosted-media-2",- "@odata.type": "microsoft.graph.call" + "@odata.type": "microsoft.graph.call", + "truncated": true }--> ```http The following example shows a request to make a peer-to-peer call between the bo <!-- { "blockType": "request", "name": "create-call-service-hosted-media-3",- "@odata.type": "microsoft.graph.call" + "@odata.type": "microsoft.graph.call", + "truncated": true }--> ```http |
| v1.0 | Participant Invite | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/participant-invite.md | Namespace: microsoft.graph Invite participants to the active call. -For more information about how to handle operations, see [commsoperation](../resources/commsoperation.md). +For more information about how to handle operations, see [commsOperation](../resources/commsoperation.md). >**Note:** Inviting multiple participants in one request is only supported for group calls. Content-Type: application/json ``` -### Example 3: Invite participants to a an existing group call, replacing an existing Peer-to-Peer call +### Example 3: Invite participants to an existing group call, replacing an existing Peer-to-Peer call The invite API supports only one participant when replacing an existing peer-to-peer call. Content-Type: application/json >**Note:** With a `completed` status, you can expect to receive notifications about how your original peer-to-peer call has been terminated and deleted. +### Example 5: Move one participant from one meeting to another ++You can move one participant from one meeting to another if these two meetings have been created by the same application. +For more information about how to create an online meeting, see [Create onlineMeeting](/graph/api/application-post-onlinemeetings). ++> **Note:** The invite API can move only one participant per request. If you provide more than one participant in the request body, the invite API will move only the first one. ++#### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "participant-invite-move" +}--> ++```http +POST /communications/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/participants/invite +Content-Type: application/json ++{ + "participants": [ + { + "@odata.type": "#microsoft.graph.invitationParticipantInfo", + "replacesCallId": "a7ebfb2d-871e-419c-87af-27290b22e8db", + "participantId": "7d501bf1-5ee4-4605-ba92-0ae4513c611c", + "identity": { + "@odata.type": "#microsoft.graph.identitySet", + "user": { + "@odata.type": "#microsoft.graph.identity", + "id": "682b6c37-0729-4fab-ace6-d730d5d9137e", + "identityProvider": "AAD" + } + } + } + ], + "clientContext": "f2fa86af-3c51-4bc2-8fc0-475452d9764f" +} +``` ++#### Response ++The following is an example of the response. ++<!-- { + "blockType": "response", + "truncated": "true", + "@odata.type": "microsoft.graph.inviteParticipantsOperation", + "name": "participant-invite-move" +}--> ++``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.inviteParticipantsOperation", + "id": "278405a3-f568-4b3e-b684-009193463064", + "status": "Running", + "clientContext": "f2fa86af-3c51-4bc2-8fc0-475452d9764f", + "resultInfo": null, + "participants": [ + { + "endpointType": null, + "id": null, + "replacesCallId": "a7ebfb2d-871e-419c-87af-27290b22e8db", + "participantId": "7d501bf1-5ee4-4605-ba92-0ae4513c611c", + "identity": { + "user": { + "id": "682b6c37-0729-4fab-ace6-d730d5d9137e", + "displayName": "Participant", + "identityProvider": "AAD", + "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47" + }, + "application": null, + "device": null, + "phone": null + } + } + ] +} +``` ++#### Notification - operation completed ++``` http +POST https://bot.contoso.com/api/calls +Content-Type: application/json +``` ++<!-- { + "blockType": "example", + "@odata.type": "microsoft.graph.commsNotifications" +}--> ++```json +{ + "@odata.type":"#microsoft.graph.commsNotifications", + "value":[ + { + "@odata.type":"#microsoft.graph.commsNotification", + "changeType":"deleted", + "resource":"/app/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/operations/278405a3-f568-4b3e-b684-009193463064", + "resourceUrl":"/communications/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/operations/278405a3-f568-4b3e-b684-009193463064", + "resourceData":{ + "@odata.type":"#microsoft.graph.inviteParticipantsOperation", + "participants":[ + { + "@odata.type":"#microsoft.graph.invitationParticipantInfo", + "identity":{ + "@odata.type":"#microsoft.graph.identitySet", + "user":{ + "@odata.type":"#microsoft.graph.identity", + "id":"682b6c37-0729-4fab-ace6-d730d5d9137e", + "identityProvider":"AAD", + "tenantId":"72f988bf-86f1-41af-91ab-2d7cd011db47" + } + } + } + ], + "status":"completed", + "clientContext":"f2fa86af-3c51-4bc2-8fc0-475452d9764f", + "id":"278405a3-f568-4b3e-b684-009193463064" + } + } + ] +} +``` ++#### Notification - roster updated with participant added ++```http +POST https://bot.contoso.com/api/calls +Content-Type: application/json +``` ++<!-- { + "blockType": "example", + "@odata.type": "microsoft.graph.commsNotifications" +}--> ++```json +{ + "@odata.type":"#microsoft.graph.commsNotifications", + "value":[ + { + "@odata.type":"#microsoft.graph.commsNotification", + "changeType":"updated", + "resource":"/communications/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/participants", + "resourceUrl":"/communications/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/participants", + "resourceData":[ + { + "@odata.type":"#microsoft.graph.participant", + "info":{ + "@odata.type":"#microsoft.graph.participantInfo", + "identity":{ + "@odata.type":"#microsoft.graph.identitySet", + "user":{ + "@odata.type":"#microsoft.graph.identity", + "id":"682b6c37-0729-4fab-ace6-d730d5d9137e", + "identityProvider":"AAD", + "tenantId":"72f988bf-86f1-41af-91ab-2d7cd011db47" + } + }, + "endpointType":"default" + }, + "mediaStreams":[ + { + "@odata.type":"#microsoft.graph.mediaStream", + "mediaType":"audio", + "sourceId":"1", + "direction":"sendReceive", + "serverMuted":false + } + ], + "isMuted":false, + "isInLobby":false, + "id":null + } + ] + } + ] +} +``` + <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- |
| v1.0 | Subjectrightsrequest Post Notes | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/subjectrightsrequest-post-notes.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|SubjectRightsRequest.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported| +|Application|Not supported.| ## HTTP request The following table shows the properties that are required when you create the [ |Property|Type|Description| |:|:|:|-|content|[microsoft.graph.itemBody](../resources/itembody.md)|The note content for the request| +|content|[microsoft.graph.itemBody](../resources/itembody.md)|The note content for the request.| ## Response If successful, this method returns a `201 Created` response code and an [authore ### Request +The following is an example of a request. + # [HTTP](#tab/http) <!-- { "blockType": "request", Content-Type: application/json ### Response++The following is an example of the response. + >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", |
| v1.0 | Invitationparticipantinfo | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/invitationparticipantinfo.md | Represents an entity that is being invited to a group call. | Property | Type | Description | | : | :- | :-- |-| endpointType | String | The type of endpoint. Possible values are: `default`, `voicemail`. | +| endpointType | String | The type of the endpoint. Possible values are: `default`, `voicemail`. | | identity | [identitySet](identityset.md) | The [identitySet](identityset.md) associated with this invitation. |-| replacesCallId | String | Optional. The call which the target idenity is currently a part of. This call will be dropped once the participant is added. | +| participantId | String | Optional. The ID of the target participant. | +| replacesCallId | String | Optional. The call which the target identity is currently a part of. For peer-to-peer case, the call will be dropped once the participant is added successfully. | ## JSON representation The following is a JSON representation of the resource. }--> ```json {- "endpointType": "default | voicemail", + "endpointType": "String", "identity": {"@odata.type": "#microsoft.graph.identitySet"},+ "participantId": "String", "replacesCallId": "String" } ``` |
| v1.0 | Contenttype Addcopyfromcontenttypehub | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/contenttype-addcopyfromcontenttypehub.md | + + Title: "contentType: addCopyFromContentTypeHub" +description: "Add or sync a copy of a published content type from the content type hub to a target site or a list." ++ms.localizationpriority: medium +++# contentType: addCopyFromContentTypeHub +Namespace: microsoft.graph ++Add or sync a copy of a published content type from the content type hub to a target [site](../resources/site.md) or a [list](../resources/list.md). ++This method is part of the content type publishing changes to optimize the syncing of published content types to sites and lists, effectively switching from a "push everywhere" to "pull as needed" approach. The method allows users to pull content types directly from the content type hub to a site or list. For more information, see [contentType: getCompatibleHubContentTypes](contenttype-getcompatiblehubcontenttypes.md) and the blog post [Syntex Product Updates ΓÇô August 2021](https://techcommunity.microsoft.com/t5/sharepoint-syntex-blog/syntex-product-updates-august-2021/ba-p/2606438). ++## 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/{siteId}/lists/{listId}/contentTypes/addCopyFromContentTypeHub +POST /sites/{siteId}/contentTypes/addCopyFromContentTypeHub +``` ++## 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 parameter that can be used with this action. ++|Parameter|Type|Description| +|:|:|:| +|contentTypeId|String| The ID of the content type in the content type hub that will be added to a target site or a list.| ++++## Response ++If successful, this action returns a `200 OK` response code and a [contentType](../resources/contenttype.md) object in the response body if the content type is added synchronously or a `202 Accepted` response code if the content type will be synced asynchronously. The response will also contain a `Location` header, which contains the location of the [richLongRunningOperation](../resources/richlongrunningoperation.md) that was created to handle the copy/sync operation. In case of an asynchronous operation, it can take up to 70 minutes to sync or add a content type. ++## Examples ++### Example 1: Synchronous pull ++The following example adds or syncs a content type synchronously based on certain backend conditions. ++#### Request ++The following is an example of a synchronous operation. ++<!-- { + "blockType": "request", + "name": "contenttype_addcopyfromcontenttypehub" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/sites/root/lists/Documents/contentTypes/addCopyFromContentTypeHub +Content-Type: application/json +Content-length: 33 ++{ + "contentTypeId": "0x0101" +} +``` ++#### 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.contentType" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.contentType", + "id": "0x0101", + "description": "Document content type", + "group": "Document Content Types", + "hidden": false, + "isBuiltIn": true, + "name": "Document" +} +``` ++### Example 2: Asynchronous pull ++The following example adds or syncs a content type asynchronously because the backend conditions for a synchronous operation are not fulfilled. ++#### Request ++The following is an example of an asynchronous operation. ++<!-- { + "blockType": "request", + "name": "contenttype_addcopyfromcontenttypehub" +} +--> +``` http +POST https://graph.microsoft.com/v1.0/sites/root/lists/Documents/contentTypes/addCopyFromContentTypeHub +Content-Type: application/json +Content-length: 33 ++{ + "contentTypeId": "0x0101" +} +``` +++#### Response ++The following is an example of the response. ++<!-- { + "blockType": "response" +} +--> +``` http +HTTP/1.1 202 Accepted +location: https://graph.microsoft.com/v1.0/sites/root/lists/Documents/operations/contentTypeCopy,0x0101 +``` |
| v1.0 | Contenttype Getcompatiblehubcontenttypes | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/contenttype-getcompatiblehubcontenttypes.md | + + Title: "contentType: getCompatibleHubContentTypes" +description: "Get a list of compatible content types from the content type hub that can be added to a target site or a list." ++ms.localizationpriority: medium +++# contentType: getCompatibleHubContentTypes +Namespace: microsoft.graph ++Get a list of compatible content types from the content type hub that can be added to a target [site](../resources/site.md) or a [list](../resources/list.md). ++This method is part of the content type publishing changes to optimize the syncing of published content types to sites and lists, effectively switching from a "push everywhere" to "pull as needed" approach. The method allows users to pull content types directly from the content type hub to a site or list. For more information, see [contentType: addCopyFromContentTypeHub](contenttype-addcopyfromcontenttypehub.md) and the blog post [Syntex Product Updates ΓÇô August 2021](https://techcommunity.microsoft.com/t5/sharepoint-syntex-blog/syntex-product-updates-august-2021/ba-p/2606438). ++## 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 +GET /sites/{siteId}/lists/{listId}/contentTypes/getCompatibleHubContentTypes +GET /sites/{siteId}/contentTypes/getCompatibleHubContentTypes +``` ++## 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 collection of [contentType](../resources/contenttype.md) objects in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "contenttype_getcompatiblehubcontenttypes" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/sites/root/lists/Documents/contentTypes/getCompatibleHubContentTypes +``` ++### 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.contentType", + "isCollection": true +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "@odata.type": "#microsoft.graph.contentType", + "id": "0x0101", + "description": "Document content type", + "group": "Document Content Types", + "hidden": false, + "isBuiltIn": true, + "name": "Document" + } + ] +} +``` + |
| v1.0 | Group Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-delete.md | ms.prod: "groups" doc_type: apiPageType -# Delete group +# Delete group Namespace: microsoft.graph |
| v1.0 | Group Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-get.md | ms.prod: "groups" doc_type: apiPageType -# Get group +# Get group Namespace: microsoft.graph |
| v1.0 | List List Operations | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/list-list-operations.md | + + Title: "List operations on a list" +description: "Get a list of richLongRunningOperations associated with a list." ++ms.localizationpriority: medium +++# List operations on a list ++Namespace: microsoft.graph ++Get a list of [rich long-running operations](../resources/richlongrunningoperation.md) associated with 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| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{siteId}/lists/{listId}/operations +``` ++## 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 [richLongRunningOperation](../resources/richlongrunningoperation.md) objects in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "list_richlongrunningoperation" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/sites/root/lists/Documents +``` +++### 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.richLongRunningOperation", + "isCollection": true +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "id": "contentTypeCopy,0x010100298A15181454D84EBB62EDD7559FCBFE", + "createdDateTime": "2022-01-24T16:28:23Z", + "status": "notStarted", + "type": "contentTypeCopy" + } + ] +} +``` + |
| v1.0 | Participant Invite | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/participant-invite.md | Namespace: microsoft.graph Invite participants to the active call. -For more information about how to handle operations, see [commsoperation](../resources/commsoperation.md). +For more information about how to handle operations, see [commsOperation](../resources/commsoperation.md). >**Note:** Inviting multiple participants in one request is only supported for group calls. Content-Type: application/json ``` -### Example 3: Invite participants to a an existing group call, replacing an existing Peer-to-Peer call +### Example 3: Invite participants to an existing group call, replacing an existing Peer-to-Peer call The invite API supports only one participant when replacing an existing peer-to-peer call. Content-Type: application/json >**Note:** With a `completed` status, you can expect to receive notifications about how your original peer-to-peer call has been terminated and deleted. +### Example 5: Move one participant from one meeting to another ++You can move one participant from one meeting to another if these two meetings have been created by the same application. +For more information about how to create an online meeting, see [Create onlineMeeting](/graph/api/application-post-onlinemeetings). ++> **Note:** The invite API can move only one participate per request. If you provide more than one participant in the request body, the invite API will move only the first one. ++#### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "participant-invite-move" +}--> ++```http +POST /communications/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/participants/invite +Content-Type: application/json ++{ + "participants": [ + { + "@odata.type": "#microsoft.graph.invitationParticipantInfo", + "replacesCallId": "a7ebfb2d-871e-419c-87af-27290b22e8db", + "participantId": "7d501bf1-5ee4-4605-ba92-0ae4513c611c", + "identity": { + "@odata.type": "#microsoft.graph.identitySet", + "user": { + "@odata.type": "#microsoft.graph.identity", + "id": "682b6c37-0729-4fab-ace6-d730d5d9137e", + "identityProvider": "AAD" + } + } + } + ], + "clientContext": "f2fa86af-3c51-4bc2-8fc0-475452d9764f" +} +``` ++#### Response ++The following is an example of the response. ++<!-- { + "blockType": "response", + "truncated": "true", + "@odata.type": "microsoft.graph.inviteParticipantsOperation", + "name": "participant-invite-move" +}--> ++``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "@odata.type": "#microsoft.graph.inviteParticipantsOperation", + "id": "278405a3-f568-4b3e-b684-009193463064", + "status": "Running", + "clientContext": "f2fa86af-3c51-4bc2-8fc0-475452d9764f", + "resultInfo": null, + "participants": [ + { + "endpointType": null, + "id": null, + "replacesCallId": "a7ebfb2d-871e-419c-87af-27290b22e8db", + "participantId": "7d501bf1-5ee4-4605-ba92-0ae4513c611c", + "identity": { + "user": { + "id": "682b6c37-0729-4fab-ace6-d730d5d9137e", + "displayName": "Participant", + "identityProvider": "AAD", + "tenantId": "72f988bf-86f1-41af-91ab-2d7cd011db47" + }, + "application": null, + "device": null, + "phone": null + } + } + ] +} +``` ++#### Notification - operation completed ++``` http +POST https://bot.contoso.com/api/calls +Content-Type: application/json +``` ++<!-- { + "blockType": "example", + "@odata.type": "microsoft.graph.commsNotifications" +}--> ++```json +{ + "@odata.type":"#microsoft.graph.commsNotifications", + "value":[ + { + "@odata.type":"#microsoft.graph.commsNotification", + "changeType":"deleted", + "resource":"/app/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/operations/278405a3-f568-4b3e-b684-009193463064", + "resourceUrl":"/communications/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/operations/278405a3-f568-4b3e-b684-009193463064", + "resourceData":{ + "@odata.type":"#microsoft.graph.inviteParticipantsOperation", + "participants":[ + { + "@odata.type":"#microsoft.graph.invitationParticipantInfo", + "identity":{ + "@odata.type":"#microsoft.graph.identitySet", + "user":{ + "@odata.type":"#microsoft.graph.identity", + "id":"682b6c37-0729-4fab-ace6-d730d5d9137e", + "identityProvider":"AAD", + "tenantId":"72f988bf-86f1-41af-91ab-2d7cd011db47" + } + } + } + ], + "status":"completed", + "clientContext":"f2fa86af-3c51-4bc2-8fc0-475452d9764f", + "id":"278405a3-f568-4b3e-b684-009193463064" + } + } + ] +} +``` ++#### Notification - roster updated with participant added ++```http +POST https://bot.contoso.com/api/calls +Content-Type: application/json +``` ++<!-- { + "blockType": "example", + "@odata.type": "microsoft.graph.commsNotifications" +}--> ++```json +{ + "@odata.type":"#microsoft.graph.commsNotifications", + "value":[ + { + "@odata.type":"#microsoft.graph.commsNotification", + "changeType":"updated", + "resource":"/communications/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/participants", + "resourceUrl":"/communications/calls/ab6233a5-20b7-4c5e-bea2-ce56c9776429/participants", + "resourceData":[ + { + "@odata.type":"#microsoft.graph.participant", + "info":{ + "@odata.type":"#microsoft.graph.participantInfo", + "identity":{ + "@odata.type":"#microsoft.graph.identitySet", + "user":{ + "@odata.type":"#microsoft.graph.identity", + "id":"682b6c37-0729-4fab-ace6-d730d5d9137e", + "identityProvider":"AAD", + "tenantId":"72f988bf-86f1-41af-91ab-2d7cd011db47" + } + }, + "endpointType":"default" + }, + "mediaStreams":[ + { + "@odata.type":"#microsoft.graph.mediaStream", + "mediaType":"audio", + "sourceId":"1", + "direction":"sendReceive", + "serverMuted":false + } + ], + "isMuted":false, + "isInLobby":false, + "id":null + } + ] + } + ] +} +``` + <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- |
| v1.0 | Richlongrunningoperation Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/richlongrunningoperation-get.md | + + Title: "Get richLongRunningOperation" +description: "Get the status of a rich long-running operation on a site or list." ++ms.localizationpriority: medium +++# Get richLongRunningOperation +Namespace: microsoft.graph ++Get the status of a [rich long-running operation](../resources/richlongrunningoperation.md) on a [site](../resources/site.md) or 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| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{siteId}/operations/{richLongRunningOperation-ID} +GET /sites/{siteId}/lists/{listId}/operations/{richLongRunningOperation-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 [richLongRunningOperation](../resources/richlongrunningoperation.md) object in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "get_richlongrunningoperation" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/sites/root/operations/contentTypeCopy,0x010100298A15181454D84EBB62EDD7559FCBFE +``` +++### 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.richLongRunningOperation" +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "id": "contentTypeCopy,0x010100298A15181454D84EBB62EDD7559FCBFE", + "createdDateTime": "2022-01-24T16:28:23Z", + "resourceId": "0x010100298A15181454D84EBB62EDD7559FCBFE", + "resourceLocation": "https://graph.microsoft.com/v1.0/sites/5b3ea0e2-5fed-45ab-a8b8-7f7cd97189d6/contentTypes/0x010100298A15181454D84EBB62EDD7559FCBFE", + "status": "succeeded", + "type": "contentTypeCopy" +} +``` + |
| v1.0 | Securescorecontrolprofile Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/securescorecontrolprofile-update.md | Title: "Update secureScoreControlProfile" description: "Update an editable secureScoreControlProfile object within any integrated solution to change various properties, such as assignedTo or tenantNote." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Security List Securescorecontrolprofiles | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/security-list-securescorecontrolprofiles.md | Title: "List secureScoreControlProfiles" description: "Retrieve the properties and relationships of a secureScoreControlProfiles object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Security List Securescores | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/security-list-securescores.md | Title: "List secureScores" description: "Retrieve a list of secureScore objects." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Shares Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/shares-get.md | Last updated 09/10/2017 Title: Access shared items ms.localizationpriority: medium description: "Access a shared DriveItem or a collection of shared items by using a shareId or sharing URL." doc_type: apiPageType # Accessing shared DriveItems |
| v1.0 | Singlevaluelegacyextendedproperty Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/singlevaluelegacyextendedproperty-get.md | Title: "Get singleValueLegacyExtendedProperty" description: "You can get a single resource instance expanded with a specific extended property, or a collection of resource instances" ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Singlevaluelegacyextendedproperty Post Singlevalueextendedproperties | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/singlevaluelegacyextendedproperty-post-singlevalueextendedproperties.md | Title: "Create single-value extended property" description: "Create one or more single-value extended properties in a new or existing instance of a resource. " ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Site List Operations | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/site-list-operations.md | + + Title: "List operations on a site" +description: "Get a list of richLongRunningOperations associated with a site." ++ms.localizationpriority: medium +++# List operations on a site ++Namespace: microsoft.graph ++Get a list of [rich long-running operations](../resources/richlongrunningoperation.md) associated with a [site](../resources/site.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| ++## HTTP request ++<!-- { + "blockType": "ignored" +} +--> +``` http +GET /sites/{siteId}/operations +``` ++## 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 [richLongRunningOperation](../resources/richlongrunningoperation.md) objects in the response body. ++## Examples ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "list_richlongrunningoperation" +} +--> +``` http +GET https://graph.microsoft.com/v1.0/sites/root/operations +``` ++### 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.richLongRunningOperation", + "isCollection": true +} +--> +``` http +HTTP/1.1 200 OK +Content-Type: application/json ++{ + "value": [ + { + "id": "contentTypeCopy,0x010100298A15181454D84EBB62EDD7559FCBFE", + "createdDateTime": "2022-01-24T16:28:23Z", + "resourceId": "0x010100298A15181454D84EBB62EDD7559FCBFE", + "resourceLocation": "https://graph.microsoft.com/v1.0/sites/5b3ea0e2-5fed-45ab-a8b8-7f7cd97189d6/contentTypes/0x010100298A15181454D84EBB62EDD7559FCBFE", + "status": "succeeded", + "type": "contentTypeCopy" + } + ] +} +``` + |
| v1.0 | Sites List Followed | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/sites-list-followed.md | |
| v1.0 | Subjectrightsrequest Post Notes | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/subjectrightsrequest-post-notes.md | One of the following permissions is required to call this API. To learn more, in |:|:| |Delegated (work or school account)|SubjectRightsRequest.ReadWrite.All| |Delegated (personal Microsoft account)|Not supported.|-|Application|Not supported| +|Application|Not supported.| ## HTTP request The following table shows the properties that are required when you create the [ |Property|Type|Description| |:|:|:|-|content|[microsoft.graph.itemBody](../resources/itembody.md)|The note content for the request| +|content|[microsoft.graph.itemBody](../resources/itembody.md)|The note content for the request.| ## Response If successful, this method returns a `201 Created` response code and an [authore ### Request +The following is an example of a request. + # [HTTP](#tab/http) <!-- { "blockType": "request", Content-Type: application/json +### Response +The following is an example of the response. -### Response >**Note:** The response object shown here might be shortened for readability. <!-- { "blockType": "response", |
| v1.0 | Termstore Group Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-group-delete.md | Title: "Delete group" description: "Delete a group object in a term store." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Group Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-group-get.md | Title: "Get group" description: "Read the properties and relationships of a term store group object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Group Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-group-post.md | Title: "Create group" + Title: "Create termStore group" description: "Create a new group object in a term store." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore List Groups | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-list-groups.md | Title: "List groups" + Title: "List termStore groups" description: "Get a list of group objects in a term store." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Set Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-set-delete.md | Title: "Delete set" description: "Delete a set object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Set Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-set-get.md | Title: "Get set" description: "Read the properties and relationships of a set object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Set Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-set-post.md | Title: "Create set" description: "Create a new set object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Set Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-set-update.md | Title: "Update set" description: "Update the properties of a set object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Store Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-store-get.md | Title: "Get store" description: "Read the properties and relationships of a store object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Store Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-store-update.md | Title: "Update store" description: "Update the properties of a store object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Term Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-term-delete.md | Title: "Delete term" description: "Delete a term object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Term Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-term-get.md | Title: "Get term" description: "Read the properties and relationships of a term object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Term List Children | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-term-list-children.md | Title: "List children" description: "Get the terms from the children navigation property." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Term List Relations | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-term-list-relations.md | Title: "List relations" description: "Get the relations from the relations navigation property." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Term Post | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-term-post.md | Title: "Create term" description: "Create a new term object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Termstore Term Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/termstore-term-update.md | Title: "Update term" description: "Update the properties of a term object." ms.localizationpriority: medium doc_type: apiPageType |
| v1.0 | Contenttype | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/contentType.md | Content types allow you to define a set of columns that must be present on every |[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.|+|[getCompatibleHubContentTypes](../api/contenttype-getcompatiblehubcontenttypes.md)|[contentType](../resources/contenttype.md) collection|Get a list of compatible content types from the content type hub that can be added to a target [site](../resources/site.md) or a [list](../resources/list.md).| +|[addCopyFromContentTypeHub](../api/contenttype-addcopyfromcontenttypehub.md)|[contentType](../resources/contenttype.md)|Add or sync a copy of a published content type from the content type hub to a target [site](../resources/site.md) or a [list](../resources/list.md).| ## Properties |
| v1.0 | Enums | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/enums.md | Possible values for user account types (group membership), per Windows definitio |dontKnow| |notNotified| |unknownFutureValue|++### longRunningOperationStatus values ++| Member| +|:--| +|notStarted| +|running| +|succeeded| +|failed| +|unknownFutureValue| |
| v1.0 | Invitationparticipantinfo | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/invitationparticipantinfo.md | This resource is used to represent the entity that is being invited to a group c | Property | Type | Description | | : | :- | :-- | | identity | [identitySet](identityset.md) | The [identitySet](identityset.md) associated with this invitation. |-| replacesCallId | String | Optional. The call which the target identity is currently a part of. This call will be dropped once the participant is added. | +| participantId | String | Optional. The ID of the target participant. | +| replacesCallId | String | Optional. The call which the target identity is currently a part of. For peer-to-peer case, the call will be dropped once the participant is added successfully. | ## JSON representation The following is a JSON representation of the resource. ```json { "identity": {"@odata.type": "#microsoft.graph.identitySet"},+ "participantId": "String", "replacesCallId": "String" } ``` |
| v1.0 | List | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/list.md | All examples below are relative to a site, for example, `https://graph.microsoft | [Delete list item][] | DELETE /lists/{list-id}/items/{item-id} | [Create list item][] | POST /lists/{list-id} | [Get WebSocket channel][] | GET /lists/{list-id}/subscriptions/socketIo+| [List operations](../api/list-list-operations.md)| GET /lists/{list-id}/operations [Get list]: ../api/list-get.md [Create list]: ../api/list-create.md The **list** resource has the following relationships to other resources. | **items** | Collection([listItem][]) | All items contained in the list. | **columns** | Collection([columnDefinition][]) | The collection of field definitions for this list. | **contentTypes** | Collection([contentType][]) | The collection of content types present in this list.+| **operations** | [richLongRunningOperation](../resources/richlongrunningoperation.md) collection | The collection of long-running operations on the list. | **subscriptions** | Collection([subscription][]) | The set of subscriptions on the list. [baseItem]: baseitem.md The following is a JSON representation of the resource. "hidden": false, "template": "documentLibrary | genericList | survey | links | announcements | contacts | accessRequest ..." },+ "operations": [ { "@odata.type": "microsoft.graph.richLongRunningOperation" }], "system": false, "subscriptions": [ {"@odata.type": "microsoft.graph.subscription"} ], |
| v1.0 | Richlongrunningoperation | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/richlongrunningoperation.md | + + Title: "richLongRunningOperation resource type" +description: "Represents the status of a long-running operation on a site or a list." ++ms.localizationpriority: medium +++# richLongRunningOperation resource type ++Namespace: microsoft.graph ++Represents the status of a long-running operation on a [site](../resources/site.md) or a [list](../resources/list.md). ++## Methods +|Method|Return type|Description| +|:|:|:| +|[Get richLongRunningOperation](../api/richlongrunningoperation-get.md)|[richLongRunningOperation](../resources/richlongrunningoperation.md)|Get the status of a [rich long-running operation](../resources/richlongrunningoperation.md) on a [site](../resources/site.md) or a [list](../resources/list.md).| ++## Properties ++|Property|Type|Description| +|:|:|:| +|createdDateTime|DateTimeOffset|The date and time when this operation was created.| +|error|[publicError](../resources/publicerror.md)| Error that caused the operation to fail.| +|id|String|Unique identifier for the operation. Inherited from [entity](../resources/entity.md).| +|lastActionDateTime|DateTimeOffset| The date and time when the last action was performed on this operation.| +|percentageComplete|Int32|A value between 0 and 100 that indicates the progress of the operation.| +|resourceId|String|The unique identifier for the result.| +|resourceLocation|String|The canonical URL of the resource.| +|status|longRunningOperationStatus|The status of the long-running operation. Possible values are: `notStarted`, `running`, `succeeded`, `failed`, `unknownFutureValue`.| +|statusDetail|String|The detail about the status value.| +|type|String| The type of the operation.| ++## Relationships +None. ++## JSON representation +The following is a JSON representation of the resource. +<!-- { + "blockType": "resource", + "keyProperty": "id", + "@odata.type": "microsoft.graph.richLongRunningOperation", + "openType": false +} +--> +``` json +{ + "@odata.type": "#microsoft.graph.richLongRunningOperation", + "createdDateTime": "String (timestamp)", + "error": { + "@odata.type": "microsoft.graph.publicError" + }, + "id": "String (identifier)", + "lastActionDateTime": "String (timestamp)", + "percentageComplete": "Integer", + "resourceId": "String", + "resourceLocation": "String", + "status": "String", + "statusDetail": "String", + "type": "String" +} +``` + |
| v1.0 | Site | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/site.md | The **site** resource provides metadata and relationships for a SharePoint site. | [Create permissions][] | POST /sites/{site-id}/permissions | [Delete permission][] | DELETE /sites/{site-id}/permissions/{permission-id} | [Update permission][] | PATCH /sites/{site-id}/permissions/{permission-id}+| [List operations](../api/site-list-operations.md)|[richLongRunningOperation](../resources/richlongrunningoperation.md) collection|Get a list of [rich long-running operations](../resources/richlongrunningoperation.md) associated with a [site](../resources/site.md). [Get site]: ../api/site-get.md [Get root site]: ../api/site-get.md The `root` identifier always references the root site for a given target, as fol | **items** | Collection([baseItem][]) | Used to address any item contained in this site. This collection can't be enumerated. | **lists** | Collection([list][]) | The collection of lists under this site. | **onenote** | [onenote][] | Calls the OneNote service for notebook related operations.+| **operations** | [richLongRunningOperation](../resources/richlongrunningoperation.md) collection | The collection of long-running operations on the site. | **permissions** | Collection([permission][]) | The permissions associated with the site. Nullable. | **sites** | Collection([site][]) | The collection of the sub-sites under this site. | **termStore** | [microsoft.graph.termStore.store] | The default termStore under this site. The **site** resource is derived from [**baseItem**](baseitem.md) and inherits p "drives": [ { "@odata.type": "microsoft.graph.drive" }], "items": [ { "@odata.type": "microsoft.graph.baseItem" }], "lists": [ { "@odata.type": "microsoft.graph.list" }],+ "operations": [ { "@odata.type": "microsoft.graph.richLongRunningOperation" }], "permissions": [ { "@odata.type": "microsoft.graph.permission" }], "sites": [ { "@odata.type": "microsoft.graph.site"} ], "columns": [ { "@odata.type": "microsoft.graph.columnDefinition" }], |
| 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: href: api/site-list-subsites.md - name: Search for sites href: api/site-search.md+ - name: List operations + href: api/site-list-operations.md - name: Permissions href: resources/permission.md items: items: href: api/list-list-contenttypes.md - name: Add copy of content type href: api/contenttype-addcopy.md+ - name: List operations + href: api/list-list-operations.md - name: Columns items: - name: Column definition items: href: api/contenttype-unpublish.md - name: Add copy to list href: api/contenttype-addcopy.md+ - name: Add or sync from hub + href: api/contenttype-addcopyfromcontenttypehub.md - name: Associate with hub sites href: api/contenttype-associatewithhubsites.md - name: Copy to default content location items: href: api/contenttype-list-columns.md - name: Create column href: api/contenttype-post-columns.md+ - name: Get compatible from hub + href: api/contenttype-getcompatiblehubcontenttypes.md - name: List items href: resources/listitem.md items: items: href: api/listitem-list-versions.md - name: Get item analytics href: api/itemanalytics-get.md+ - name: Rich long-running operation + items: + - name: Rich long-running operation + href: resources/richLongRunningOperation.md + - name: Get + href: api/richlongrunningoperation-get.md - name: Taxonomy displayname: Taxonomy API items: |