Service | Microsoft Docs article | Related commit history on GitHub | Change details |
---|---|---|---|
v1.0 | Addlargegalleryviewoperation Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/addlargegalleryviewoperation-get.md | + + Title: "Get addLargeGalleryViewOperation" +description: "Get the status of an operation that adds the large gallery view to a call." ++ms.localizationpriority: medium +++# Get addLargeGalleryViewOperation ++Namespace: microsoft.graph +++Get the status of an [operation](../resources/addlargegalleryviewoperation.md) that adds the large gallery view to a call. ++## 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) | Not supported. | +| Delegated (personal Microsoft account) | Not supported. | +| Application | None. | ++## HTTP request +<!-- { "blockType": "ignored" } --> +```http +GET /app/calls/{callId}/operations/{id} +GET /communications/calls/{callId}/operations/{id} +``` ++> **Note:** The `/app` path is deprecated. Going forward, use the `/communications` path. ++## 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 an [addLargeGalleryViewOperation](../resources/addlargegalleryviewoperation.md) object in the response body. ++## Example ++### Request ++The following is an example of a request. ++<!-- { + "blockType": "request", + "name": "get-addLargeGalleryViewOperation-1" +}--> ++```http +GET https://graph.microsoft.com/beta/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896/operations/e33176d4-836a-4fd7-b95a-d11bda52811d +``` ++### Response ++The following is an example of the response. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "name": "get-addLargeGalleryViewOperation-1", + "truncated": true, + "@odata.type": "microsoft.graph.addLargeGalleryViewOperation" +} --> +```http +HTTP/1.1 200 OK ++{ + "@odata.type": "#microsoft.graph.addLargeGalleryViewOperation", + "clientContext": "785f4929-92ca-497b-863f-c778c77c9758", + "id": "e33176d4-836a-4fd7-b95a-d11bda52811d", + "resultInfo": null, + "status": "completed" +} +``` ++<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 +2015-10-25 14:57:30 UTC --> +<!-- +{ + "type": "#page.annotation", + "description": "Get the status of addLargeGalleryView operation.", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [ + ] +} +--> ++ |
v1.0 | Application List Extensionproperty | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/application-list-extensionproperty.md | One of the following permissions is required to call this API. To learn more, in <!-- { "blockType": "ignored" } --> ```http-GET /applications/{id}/extensionProperties +GET /applications/{application ObjectId}/extensionProperties ``` ## Optional query parameters |
v1.0 | Call Addlargegalleryview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/call-addlargegalleryview.md | + + Title: "call: addLargeGalleryView" +description: "Add the large gallery view to a call." ++ms.localizationpriority: medium +++# call: addLargeGalleryView ++Namespace: microsoft.graph +++Add the large gallery view to a call. ++## 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) | Not supported. | +| Delegated (personal Microsoft account) | Not supported. | +| Application | Calls.JoinGroupCallAsGuest.All, Calls.JoinGroupCall.All, Calls.InitiateGroupCall.All | ++## HTTP request +<!-- { "blockType": "ignored" } --> +```http +POST /app/calls/{id}/addLargeGalleryView +POST /communications/calls/{id}/addLargeGalleryView +``` ++> **Note:** The `/app` path is deprecated. Going forward, use the `/communications` path. ++## Request headers +| Name | Description | +|:--|:| +| Authorization | Bearer {token}. Required. | +| Content-Type | application/json. Required.| ++## Request body +In the request body, provide a JSON object with the following parameter. ++| Parameter | Type | Description | +|:|:--|:| +| clientContext | String | Unique client context string that can have a maximum of 256 characters. | ++## Response +If successful, this method returns a `202 Accepted` response code and an [addLargeGalleryViewOperation](../resources/addlargegalleryviewoperation.md) object in the response body. ++## Example ++### Request ++The following example shows how to add the large gallery view to a call. ++<!-- { + "blockType": "request", + "name": "addLargeGalleryView-1" +}--> +```http +POST https://graph.microsoft.com/beta/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896/addLargeGalleryView +Content-Type: application/json +Content-Length: 46 ++{ + "clientContext": "785f4929-92ca-497b-863f-c778c77c9758" +} +``` ++### Response ++The following is an example of the response. ++> **Note:** The response object shown here might be shortened for readability. ++<!-- { + "blockType": "response", + "name": "addLargeGalleryView-1", + "truncated": true, + "@odata.type": "microsoft.graph.addLargeGalleryViewOperation" +} --> +```http +HTTP/1.1 202 ACCEPTED +Location: https://graph.microsoft.com/beta/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896/operations/e33176d4-836a-4fd7-b95a-d11bda52811d ++{ + "@odata.type": "#microsoft.graph.addLargeGalleryViewOperation", + "clientContext": "785f4929-92ca-497b-863f-c778c77c9758", + "id": "e33176d4-836a-4fd7-b95a-d11bda52811d", + "resultInfo": null, + "status": "running" +} +``` ++### 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", + "resourceUrl": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896/operations/e33176d4-836a-4fd7-b95a-d11bda52811d", + "resourceData": { + "@odata.type": "#microsoft.graph.addLargeGalleryViewOperation", + "@odata.id": "/communications/calls/57dab8b1-894c-409a-b240-bd8beae78896/operations/e33176d4-836a-4fd7-b95a-d11bda52811d", + "clientContext": "785f4929-92ca-497b-863f-c778c77c9758", + "status": "completed" + } + } + ] +} +``` ++## See also ++- [Learn how to identify the large gallery view participant in a call](/graph/cloud-communications-identifylargegalleryview) ++<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 +2015-10-25 14:57:30 UTC --> +<!-- +{ + "type": "#page.annotation", + "description": "call: addLargeGalleryView", + "keywords": "", + "section": "documentation", + "tocPath": "", + "suppressions": [ + ] +} +--> |
v1.0 | Extensionproperty Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/extensionproperty-delete.md | One of the following permissions is required to call this API. To learn more, in <!-- { "blockType": "ignored" } --> ```http-DELETE /applications/{id}/extensionProperties/{id} +DELETE /applications/{application ObjectId}/extensionProperties/{id} ``` ## Request headers |
v1.0 | Extensionproperty Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/extensionproperty-get.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http-GET /applications/{applicationsId}/extensionProperties/{extensionPropertyId} +GET /applications/{application ObjectId}/extensionProperties/{extensionPropertyId} ``` ## Optional query parameters |
v1.0 | Group Post Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/group-post-approleassignments.md | Namespace: microsoft.graph Use this API to assign an app role to a group. All direct members of the group will be considered assigned. To grant an app role assignment to a group, you need three identifiers: -- `principalId`: The `id` of the group to which you are assigning the app role.-- `resourceId`: The `id` of the resource `servicePrincipal` which has defined the app role.-- `appRoleId`: The `id` of the `appRole` (defined on the resource service principal) to assign to the group.+- **principalId**: The ID of the **group** to which you are assigning the app role. +- **resourceId**: The ID of the resource **servicePrincipal** that has defined the app role. +- **appRoleId**: The ID of the **appRole** (defined on the resource service principal) to assign to the group. Additional licenses might be required to [use a group to manage access to applications](/azure/active-directory/users-groups-roles/groups-saasapps). One of the following permissions is required to call this API. To learn more, in <!-- { "blockType": "ignored" } --> ```http-POST /groups/{id}/appRoleAssignments +POST /groups/{groupId}/appRoleAssignments ``` > [!NOTE] POST /groups/{id}/appRoleAssignments In the request body, supply a JSON representation of an [appRoleAssignment](../resources/approleassignment.md) object. +The following table shows the properties that are required when you create the [appRoleAssignment](../resources/approleassignment.md). Specify other writable properties as necessary for your **appRoleAssignment**. ++| Property | Type | Description | +|--|--|--| +| appRoleId | Guid | The identifier (**id**) for the [app role](../resources/approle.md) which is assigned to the principal. This app role must be exposed in the **appRoles** property on the resource application's service principal (**resourceId**). If the resource application has not declared any app roles, a default app role ID of `00000000-0000-0000-0000-000000000000` can be specified to signal that the principal is assigned to the resource app without any specific app roles. | +| principalId | Guid | The unique identifier (**id**) for the [group](../resources/group.md) being granted the app role. | +| resourceId | Guid | The unique identifier (**id**) for the resource [service principal](../resources/serviceprincipal.md) for which the assignment is made. | + ## Response If successful, this method returns a `201 Created` response code and an [appRoleAssignment](../resources/approleassignment.md) object in the response body. If successful, this method returns a `201 Created` response code and an [appRole ### Request -Here is an example of the request. +Here is an example of the request. In this example, ID in the URL and value of **principalId** would both be the ID of the assigned group. # [HTTP](#tab/http) Content-Type: application/json -In this example, `{id}` and `{principalId-value}` would both be the `id` of the assigned group. - ### Response Here is an example of the response. Here is an example of the response. } --> ```http-HTTP/1.1 200 OK +HTTP/1.1 201 Created Content-type: application/json { Content-type: application/json } ``` -In this example, note that the value used as the user **id** in the request URL (`cde330e5-2150-4c11-9c5b-14bfdc948c79`) is the same as the **principalId** property in the body. - <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- |
v1.0 | Addlargegalleryviewoperation | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/addlargegalleryviewoperation.md | + + Title: "addLargeGalleryViewOperation resource type" +description: "Describes the response format for an operation that adds the large gallery view." ++ms.localizationpriority: medium +++# addLargeGalleryViewOperation resource type ++Namespace: microsoft.graph +++Describes the response format for an operation that adds the large gallery view. ++Inherits from [commsOperation](commsoperation.md). ++## Methods ++| Method | Return Type | Description | +|:-|:-|:-| +| [Get addLargeGalleryViewOperation](../api/addlargegalleryviewoperation-get.md) | [addLargeGalleryViewOperation](addlargegalleryviewoperation.md) | Get the status of an operation that adds the large gallery view to a call. | ++## Properties ++| Property | Type | Description | +| :-- | :| :-| +| clientContext | String | The client context. | +| id | String | The ID of the server operation. Read-only. | +| resultInfo | [resultInfo](resultinfo.md) | The result information. Read-only. | +| status | operationStatus | The status of the operation. Possible values are: `notStarted`, `running`, `completed`, `failed`. Read-only. | ++## Relationships ++None. ++## JSON representation ++The following is a JSON representation of the resource. ++<!-- { + "blockType": "resource", + "optionalProperties": [ ++ ], + "@odata.type": "microsoft.graph.addLargeGalleryViewOperation" +}--> +```json +{ + "clientContext": "String", + "id": "String (identifier)", + "resultInfo": {"@odata.type": "#microsoft.graph.resultInfo"}, + "status": "String" +} +``` ++<!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 +2015-10-25 14:57:30 UTC --> +<!-- { + "type": "#page.annotation", + "description": "addLargeGalleryViewOperation resource", + "keywords": "", + "section": "documentation", + "tocPath": "" +}--> ++ |
v1.0 | Call | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/call.md | https://teams.microsoft.com/l/meetup-join/19:meeting_NTg0NmQ3NTctZDVkZC00YzRhLTh | [Mute all participants](../api/participant-muteall.md) | [commsOperation](commsoperation.md) | Mute all participants in the call. | | [Mute participant](../api/participant-mute.md) | [muteParticipantOperation](muteparticipantoperation.md) | Mute a participant in the group call. | | [Configure audio mixer](../api/participant-configuremixer.md) | [commsOperation](commsoperation.md) | Configure audio in multiparty conversation. |-| [Create audioRoutingGroup](../api/call-post-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) | Create a new audioRoutingGroup by posting to the audioRoutingGroups collection. | -| [List audioRoutingGroups](../api/call-list-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) collection | Get a audioRoutingGroup object collection. | +| [Create audioRoutingGroup](../api/call-post-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) | Create a new **audioRoutingGroup** by posting to the audioRoutingGroups collection. | +| [List audioRoutingGroups](../api/call-list-audioroutinggroups.md) | [audioRoutingGroup](audioroutinggroup.md) collection | Get an **audioRoutingGroup** object collection. | +| [Add large gallery view](../api/call-addlargegalleryview.md) | [addLargeGalleryViewOperation](addlargegalleryviewoperation.md) | Add the large gallery view to a call. | | **Interactive-Voice-Response** | | | | [PlayPrompt](../api/call-playprompt.md) | [playPromptOperation](playpromptoperation.md) | Play prompt in the call. | | [RecordResponse](../api/call-record.md) | [recordOperation](recordoperation.md) | Records a short audio response from the caller. | |
v1.0 | Application List Extensionproperty | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/application-list-extensionproperty.md | One of the following permissions is required to call this API. To learn more, in <!-- { "blockType": "ignored" } --> ```http-GET /applications/{id}/extensionProperties +GET /applications/{application ObjectId}/extensionProperties ``` ## Optional query parameters |
v1.0 | Extensionproperty Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/extensionproperty-delete.md | One of the following permissions is required to call this API. To learn more, in <!-- { "blockType": "ignored" } --> ```http-DELETE /applications/{id}/extensionProperties/{id} +DELETE /applications/{application ObjectId}/extensionProperties/{id} ``` ## Request headers |
v1.0 | Extensionproperty Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/extensionproperty-get.md | One of the following permissions is required to call this API. To learn more, in } --> ``` http-GET /applications/{applicationsId}/extensionProperties/{extensionPropertyId} +GET /applications/{application ObjectId}/extensionProperties/{extensionPropertyId} ``` ## Optional query parameters |
v1.0 | Group Post Approleassignments | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/group-post-approleassignments.md | Namespace: microsoft.graph Use this API to assign an app role to a group. All direct members of the group will be considered assigned. To grant an app role assignment to a group, you need three identifiers: -- `principalId`: The `id` of the group to which you are assigning the app role.-- `resourceId`: The `id` of the resource `servicePrincipal` which has defined the app role.-- `appRoleId`: The `id` of the `appRole` (defined on the resource service principal) to assign to the group.+- **principalId**: The ID of the **group** to which you are assigning the app role. +- **resourceId**: The ID of the resource **servicePrincipal** that has defined the app role. +- **appRoleId**: The ID of the **appRole** (defined on the resource service principal) to assign to the group. Additional licenses might be required to [use a group to manage access to applications](/azure/active-directory/users-groups-roles/groups-saasapps). One of the following permissions is required to call this API. To learn more, in <!-- { "blockType": "ignored" } --> ```http-POST /groups/{id}/appRoleAssignments +POST /groups/{groupId}/appRoleAssignments ``` > [!NOTE] POST /groups/{id}/appRoleAssignments In the request body, supply a JSON representation of an [appRoleAssignment](../resources/approleassignment.md) object. +The following table shows the properties that are required when you create the [appRoleAssignment](../resources/approleassignment.md). Specify other writable properties as necessary for your **appRoleAssignment**. ++| Property | Type | Description | +|--|--|--| +| appRoleId | Guid | The identifier (**id**) for the [app role](../resources/approle.md) which is assigned to the principal. This app role must be exposed in the **appRoles** property on the resource application's service principal (**resourceId**). If the resource application has not declared any app roles, a default app role ID of `00000000-0000-0000-0000-000000000000` can be specified to signal that the principal is assigned to the resource app without any specific app roles. | +| principalId | Guid | The unique identifier (**id**) for the [group](../resources/group.md) being granted the app role. | +| resourceId | Guid | The unique identifier (**id**) for the resource [service principal](../resources/serviceprincipal.md) for which the assignment is made. | ++ ## Response If successful, this method returns a `201 Created` response code and an [appRoleAssignment](../resources/approleassignment.md) object in the response body. If successful, this method returns a `201 Created` response code and an [appRole ### Request -Here is an example of the request. +Here is an example of the request. In this example, ID in the URL and value of **principalId** would both be the ID of the assigned group. # [HTTP](#tab/http) Content-Type: application/json --In this example, `{id}` and `{principalId-value}` would both be the `id` of the assigned group. - ### Response Here is an example of the response. Here is an example of the response. } --> ```http-HTTP/1.1 200 OK +HTTP/1.1 201 Created Content-type: application/json { Content-type: application/json } ``` -In this example, note that the value used as the user **id** in the request URL (`cde330e5-2150-4c11-9c5b-14bfdc948c79`) is the same as the **principalId** property in the body. - <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79 2015-10-25 14:57:30 UTC --> <!-- |
v1.0 | Rbacapplication List Roleassignments | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/rbacapplication-list-roleassignments.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Not supported. | +|Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | ## HTTP request |
v1.0 | Rbacapplication List Roledefinitions | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/rbacapplication-list-roledefinitions.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Not supported. | +|Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | ## HTTP request |
v1.0 | Rbacapplication Post Roleassignments | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/rbacapplication-post-roleassignments.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Not supported. | +|Application | EntitlementManagement.ReadWrite.All | ## HTTP request |
v1.0 | Unifiedroleassignment Delete | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/unifiedroleassignment-delete.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Not supported. | +|Application | EntitlementManagement.ReadWrite.All | ## HTTP request |
v1.0 | Unifiedroleassignment Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/unifiedroleassignment-get.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Not supported. | +|Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | ## HTTP request |
v1.0 | Unifiedroledefinition Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/api/unifiedroledefinition-get.md | One of the following permissions is required to call this API. To learn more, in |:--|:| |Delegated (work or school account) | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | |Delegated (personal Microsoft account) | Not supported. |-|Application | Not supported. | +|Application | EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All | ## HTTP request |