| Service | Microsoft Docs article | Related commit history on GitHub | Change details |
|---|---|---|---|
| v1.0 | Administrativeunit Get | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-get.md | Content-type: application/json { "@odata.context": "https://graph.microsoft.com/beta/$metadata#administrativeUnits/$entity",- "id": "4d7ea995-bc0f-45c0-8c3e-132e93bf95f8", + "id": "49eb93f2-a5a2-4567-ad66-76a3ebd01d84", "deletedDateTime": null, "displayName": "Seattle District Technical Schools", "description": "Seattle district technical schools administration",- "isMemberManagementRestricted": null, - "visibility": "HiddenMembership", - "membershipRule": null, - "membershipType": null, - "membershipRuleProcessingState": null + "visibility": null, + "membershipRule": "(user.country -eq \"United States\")", + "membershipType": "Dynamic", + "membershipRuleProcessingState": "On" } ``` |
| v1.0 | Administrativeunit Update | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/administrativeunit-update.md | In the request body, supply the values for relevant fields that should be update | Property | Type |Description| |:|:--|:-|-|description|String|Description for the administrative unit.| -|displayName|String|Display name for the administrative unit.| +| description | String | Description for the administrative unit.| +| displayName | String | Display name for the administrative unit. | +| membershipRule | String | Dynamic membership rule for the administrative unit. For more about the rules that you can use for dynamic administrative units and dynamic groups, see [Using attributes to create advanced rules](https://azure.microsoft.com/documentation/articles/active-directory-accessmanagement-groups-with-advanced-rules/).| +| membershipRuleProcessingState | String | Used to control whether the dynamic membership rule is actively processed. Set to `On` when you want the dynamic membership rule to be active and `Paused` if you want to stop updating membership dynamically. | +| membershipType | String | Membership type for the administrative unit. Can be `dynamic` or `assigned`. | +| visibility | String | Visibility for the administrative unit. If not set, then the default is `public`. Can be set to `HiddenMembership`, which hides the membership from non-members. | Since the **administrativeUnit** resource supports [extensions](/graph/extensibility-overview), you can use the `PATCH` operation to add, update, or delete your own app-specific data in custom properties of an extension in an existing **administrativeUnit** instance. Since the **administrativeUnit** resource supports [extensions](/graph/extensibi If successful, this method returns a `204 No Content` response code. ## Example+The following example sets a dynamic membership rule on an existing administrative unit to include all users whose country is United States. ### Request PATCH https://graph.microsoft.com/beta/administrativeUnits/4d7ea995-bc0f-45c0-8c Content-type: application/json {- "displayName": "Greater Seattle District Technical Schools" + "membershipType": "Dynamic", + "membershipRule": "(user.country -eq \"United States\")", + "membershipRuleProcessingState": "On" } ``` # [C#](#tab/csharp) |
| v1.0 | Directory List Administrativeunits | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-list-administrativeunits.md | HTTP/1.1 200 OK Content-type: application/json {- "@odata.context": "https://graph.microsoft.com/beta/$metadata#administrativeUnits", - "value": [ - { - "id": "4d7ea995-bc0f-45c0-8c3e-132e93bf95f8", - "deletedDateTime": null, - "displayName": "Seattle District Technical Schools", - "description": "Seattle district technical schools administration", - "isMemberManagementRestricted": null, - "visibility": "HiddenMembership", - "membershipRule": null, - "membershipType": null, - "membershipRuleProcessingState": null - } - ] + "value": [ + { + "@odata.context": "https://graph.microsoft.com/beta/$metadata#administrativeUnits/$entity", + "id": "49eb93f2-a5a2-4567-ad66-76a3ebd01d84", + "deletedDateTime": null, + "displayName": "Seattle District Technical Schools", + "description": "Seattle district technical schools administration", + "visibility": null, + "membershipRule": "(user.country -eq \"United States\")", + "membershipType": "Dynamic", + "membershipRuleProcessingState": "On" + } + ] } ``` |
| v1.0 | Directory Post Administrativeunits | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/api/directory-post-administrativeunits.md | POST /directory/administrativeUnits ## Request body In the request body, supply a JSON representation of an [administrativeUnit](../resources/administrativeunit.md) object. +You can specify the following properties when creating an **administrativeUnit**. ++| Property | Type |Description| +|:|:--|:-| +| description | String | Description for the administrative unit. Optional. | +| displayName | String | Display name for the administrative unit. Required. | +| membershipRule | String | Dynamic membership rule for the administrative unit. For more about the rules that you can use for dynamic administrative units and dynamic groups, see [Using attributes to create advanced rules](https://azure.microsoft.com/documentation/articles/active-directory-accessmanagement-groups-with-advanced-rules/). Optional. | +| membershipRuleProcessingState | String | Used to control whether the dynamic membership rule is actively processed. Set to `On` when you want the dynamic membership rule to be active and `Paused` if you want to stop updating membership dynamically. Optional. | +| membershipType | String | Membership type for the administrative unit. Can be `dynamic` or `assigned`. Optional. | +| visibility |String | Visibility for the administrative unit. If not set, then the default is `public`. Can be set to `HiddenMembership`, which hides the membership from non-members. Optional. | + Because the **administrativeUnit** resource supports [extensions](/graph/extensibility-overview), you can use the `POST` operation and add custom properties with your own data to the administrative unit while creating it. ## Response If successful, this method returns a `201 Created` response code and an [adminis ### Request -The following is an example of the request. +The following is an example of a request that creates a new administrative unit with a dynamic membership rule to include all users whose country is United States. # [HTTP](#tab/http) <!-- { Content-type: application/json { "displayName": "Seattle District Technical Schools", "description": "Seattle district technical schools administration",- "visibility": "HiddenMembership" + "membershipType": "Dynamic", + "membershipRule": "(user.country -eq \"United States\")", + "membershipRuleProcessingState": "On" } ``` # [C#](#tab/csharp) Content-type: application/json -In the request body, supply a JSON representation of an [administrativeUnit](../resources/administrativeunit.md) object. - ### Response The following is an example of the response. Content-type: application/json { "@odata.context": "https://graph.microsoft.com/beta/$metadata#administrativeUnits/$entity",- "id": "7a3dc8f3-b3a0-4164-9a99-ed36f3af039f", + "id": "49eb93f2-a5a2-4567-ad66-76a3ebd01d84", "deletedDateTime": null, "displayName": "Seattle District Technical Schools", "description": "Seattle district technical schools administration",- "visibility": "HiddenMembership" + "membershipRule": "(user.country -eq \"United States\")", + "membershipType": "Dynamic", + "membershipRuleProcessingState": "On" } ``` |
| v1.0 | Administrativeunit | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/administrativeunit.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -An administrative unit provides a conceptual container for user, group, and device directory objects. Using administrative units, a company administrator can now delegate administrative responsibilities to manage the users, groups, and devices contained within or scoped to an administrative unit to a regional or departmental administrator. +An administrative unit provides a conceptual container for User and Group directory objects. Using administrative units, a company administrator can now delegate administrative responsibilities to manage the users and groups contained within or scoped to an administrative unit to a regional or departmental administrator. This resource supports using [delta query](/graph/delta-query-overview) to track incremental additions, deletions, and updates, by providing a [delta](../api/administrativeunit-delta.md) function. This resource is an open type that allows other properties to be passed in. This topic provides descriptions of the declared properties and navigation prope |[Update](../api/administrativeunit-update.md) | [administrativeUnit](administrativeunit.md) |Update administrativeUnit object. | |[Delete](../api/administrativeunit-delete.md) | None |Delete administrativeUnit object. | |[Get delta](../api/administrativeunit-delta.md)|[administrativeUnit](administrativeunit.md)|Get newly created, updated, or deleted **administrativeUnits** without having to perform a full read of the entire resource collection.|-|[Add a member](../api/administrativeunit-post-members.md) |[directoryObject](directoryobject.md)| Add a member (user, group, or device).| -|[List members](../api/administrativeunit-list-members.md) |[directoryObject](directoryobject.md) collection| Get the list of (user, group, and device) members.| +|[Add a member](../api/administrativeunit-post-members.md) |[directoryObject](directoryobject.md)| Add a member (user or group).| +|[List members](../api/administrativeunit-list-members.md) |[directoryObject](directoryobject.md) collection| Get the list of (user and group) members.| |[Get a member](../api/administrativeunit-get-members.md) |[directoryObject](directoryobject.md)| Get a specific member.| |[Remove a member](../api/administrativeunit-delete-members.md) |[directoryObject](directoryobject.md)| Remove a member.| |[Add a scopedRoleMember](../api/administrativeunit-post-scopedrolemembers.md) |[scopedRoleMembership](scopedrolemembership.md)| Assign an Azure AD role with administrative unit scope.| This topic provides descriptions of the declared properties and navigation prope |description|String|An optional description for the administrative unit. Supports `$filter` (`eq`, `ne`, `in`, `startsWith`), `$search`.| |displayName|String|Display name for the administrative unit. Supports `$filter` (`eq`, `ne`, `not`, `ge`, `le`, `in`, `startsWith`, and `eq` on `null` values), `$search`, and `$orderBy`.| |id|String|Unique identifier for the administrative unit. Read-only. Supports `$filter` (`eq`).|-|visibility|String|Controls whether the administrative unit and its members are hidden or public. Can be set to `HiddenMembership`. If not set (value is `null`), the default behavior is public. When set to `HiddenMembership`, only members of the administrative unit can list other members of the administrative unit.| +| membershipRule | String | Dynamic membership rule for the administrative unit. For more about the rules that you can use for dynamic administrative units and dynamic groups, see [Using attributes to create advanced rules](https://azure.microsoft.com/documentation/articles/active-directory-accessmanagement-groups-with-advanced-rules/). | +| membershipRuleProcessingState | String | Used to control whether the dynamic membership rule is actively processed. Set to `On` when you want the dynamic membership rule to be active and `Paused` if you want to stop updating membership dynamically. If not set, the default behavior is `Paused`. | +| membershipType | String | Membership type for the administrative unit. Can be `dynamic` or `assigned`. If not set, the default behavior is `assigned`. | +| visibility | String | Controls whether the administrative unit and its members are hidden or public. Can be set to `HiddenMembership` or `Public`. If not set, the default behavior is `Public`. When set to `HiddenMembership`, only members of the administrative unit can list other members of the administrative unit. | ## Relationships | Relationship | Type |Description| This topic provides descriptions of the declared properties and navigation prope ## JSON representation -The following is a JSON representation of the resource. +Here is a JSON representation of the resource. <!-- { "blockType": "resource", The following is a JSON representation of the resource. "description": "String", "displayName": "String", "id": "String (identifier)",- "visibility": "String" + "visibility": "String", + "membershipType": "String", + "membershipRule": "String", + "membershipRuleProcessingState": "String" } ``` |
| v1.0 | Communications Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/communications-api-overview.md | Title: "Working with the communications API in Microsoft Graph" -description: "The Microsoft Graph communications API adds a new dimension to how your apps and services can interact with users by enabling voice and video features." + Title: "Working with the cloud communications API in Microsoft Graph" +description: "The Microsoft Graph cloud communications API adds a new dimension to how your apps and services can interact with users by enabling voice and video features." doc_type: conceptualPageType ms.prod: cloud-communications ms.localizationpriority: high -# Working with the communications API in Microsoft Graph +# Working with the cloud communications API in Microsoft Graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -The Microsoft Graph communications API adds a new dimension to how you or your organization can interact with other users by enabling core communication capabilities and features in your apps and services. You can use this API to create and receive calls, create and retrieve meeting coordinates, and check users' presence. +The Microsoft Graph cloud communications API adds a new dimension to how you or your organization can interact with other users by enabling core communication capabilities and features in your apps and services. You can use this API to create and receive calls, create and retrieve meeting coordinates, and check users' presence. -You can use the communications API to build service applications (bots) that act like participants in a call, and that create and retrieve meetings on behalf of users and to check their presence availability and activity. +You can use the cloud communications API to build service applications (bots) that act like participants in a call, and that create and retrieve meetings on behalf of users and to check their presence availability and activity. This API provides calling functionality as well as the ability to create and retrieve online meetings. You can use service applications (bots) with this API, where the bot can act as a participant in your VoIP calls or Microsoft Teams meetings, for example. ## Authorization -One of the following [permissions](/graph/permissions-reference#calls-permissions) is required to access the communications API. These permissions need to be granted by the administrator +One of the following [permissions](/graph/permissions-reference#calls-permissions) is required to access the cloud communications API. These permissions need to be granted by the administrator. | Scenario | Permissions | |:|:| One of the following [permissions](/graph/permissions-reference#calls-permission ## Common use cases -The following table lists some of the common uses for the communications API. +The following table lists some of the common uses for the cloud communications API. | Use cases | REST resources | See also | |:|:|:-|-| Creating and joining 1-1 and group calls | [Call](/graph/api/resources/call?view=graph-rest-beta)| [Methods for calls](/graph/api/resources/call?view=graph-rest-beta#methods)| -|IVR calls | | [Methods for IVR](/graph/api/resources/calls-api-ivr-overview?view=graph-rest-beta) -| Call controls (participant) | [Participant](/graph/api/resources/participant?view=graph-rest-beta) || -|Meetings|[onlineMeeting](/graph/api/resources/onlinemeeting?view=graph-rest-beta)| [Methods for meetings](/graph/api/resources/onlinemeeting?view=graph-rest-beta#methods)| -|Presence | [presence](/graph/api/resources/presence) | [Methods for presence](/graph/api/resources/presence#methods) | -| Retrieving call records | [callRecord](/graph/api/resources/callrecords-callrecord?view=graph-rest-beta) | [Webhook subscriptions](/graph/api/resources/webhooks?view=graph-rest-beta) | +| Creating and joining 1-1 and group calls | [Call](/graph/api/resources/call?view=graph-rest-beta&preserve-view=true)| [Methods for calls](/graph/api/resources/call?view=graph-rest-beta&preserve-view=true#methods)| +|IVR calls | | [Methods for IVR](/graph/api/resources/calls-api-ivr-overview?view=graph-rest-beta?&preserve-view=true) +| Call controls (participant) | [Participant](/graph/api/resources/participant?view=graph-rest-beta&preserve-view=true) || +|Meetings|[onlineMeeting](/graph/api/resources/onlinemeeting?view=graph-rest-beta&preserve-view=true)| [Methods for meetings](/graph/api/resources/onlinemeeting?view=graph-rest-beta&preserve-view=true#methods)| +|Presence | [presence](/graph/api/resources/presence?view=graph-rest-beta&preserve-view=true) | [Methods for presence](/graph/api/resources/presence?view=graph-rest-beta&preserve-view=true#methods) | +| Retrieving call records | [callRecord](/graph/api/resources/callrecords-callrecord?view=graph-rest-beta&preserve-view=true) | [Webhook subscriptions](/graph/api/resources/webhooks?view=graph-rest-beta&preserve-view=true) | ## Common properties | Resource | Properties | |:|:|-| call | [call properties](/graph/api/resources/call?view=graph-rest-beta#properties) | -| participant | [participant properties](/graph/api/resources/participant?view=graph-rest-beta#properties) | -| onlineMeeting | [onlineMeeting properties](/graph/api/resources/onlinemeeting?view=graph-rest-beta#properties) | -| presence | [presence properties](/graph/api/resources/presence#properties) | -| callRecord | [callRecord properties](/graph/api/resources/callrecords-callrecord#properties) | +| call | [call properties](/graph/api/resources/call?view=graph-rest-beta&preserve-view=true#properties) | +| participant | [participant properties](/graph/api/resources/participant?view=graph-rest-beta?view=graph-rest-v1.0&preserve-view=true#properties) | +| onlineMeeting | [onlineMeeting properties](/graph/api/resources/onlinemeeting?view=graph-rest-beta&preserve-view=true#properties) | +| presence | [presence properties](/graph/api/resources/presence?view=graph-rest-beta&preserve-view=true#properties) | +| callRecord | [callRecord properties](/graph/api/resources/callrecords-callrecord?view=graph-rest-beta&preserve-view=true#properties) | ## What's new Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set. ## See also -- [Communications API samples](https://github.com/microsoftgraph/microsoft-graph-comms-samples/)+- [Cloud communications API samples](https://github.com/microsoftgraph/microsoft-graph-comms-samples/) - [Communication Signaling SDK](https://www.nuget.org/packages/Microsoft.Graph.Communications.Calls/1.0.0-prerelease.494) - [Communication Media SDK](https://www.nuget.org/packages/Microsoft.Graph.Communications.Calls.Media/1.0.0-prerelease.494) |
| v1.0 | Loginpagetextvisibilitysettings | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/beta/resources/loginpagetextvisibilitysettings.md | Namespace: microsoft.graph [!INCLUDE [beta-disclaimer](../../includes/beta-disclaimer.md)] -This is a complex type that represents the various texts that can be hidden on the sign-in page for a tenant. +Represents the various text strings that can be hidden on the sign-in page for a tenant. ## Properties |
| v1.0 | Communications Api Overview | https://github.com/microsoftgraph/microsoft-graph-docs/commits/main/api-reference/v1.0/resources/communications-api-overview.md | Title: "Working with the communications API in Microsoft Graph" -description: "The Microsoft Graph communications API adds a new dimension to how your apps and services can interact with users by enabling voice and video features." + Title: "Working with the cloud communications API in Microsoft Graph" +description: "The Microsoft Graph cloud communications API adds a new dimension to how your apps and services can interact with users by enabling voice and video features." doc_type: conceptualPageType ms.prod: cloud-communications ms.localizationpriority: high -# Working with the communications API in Microsoft Graph +# Working with the cloud communications API in Microsoft Graph -The Microsoft Graph communications API adds a new dimension to how you or your organization can interact with other users by enabling core communication capabilities and features in your apps and services. You can use this API to create and receive calls as well as create and retrieve meeting coordinates. +The Microsoft Graph cloud communications API adds a new dimension to how you or your organization can interact with other users by enabling core communication capabilities and features in your apps and services. You can use this API to create and receive calls as well as create and retrieve meeting coordinates. -You can use the communications API to build service applications (bots) that act like participants in a call, and that create and retrieve meetings on behalf of users. +You can use the cloud communications API to build service applications (bots) that act like participants in a call, and that create and retrieve meetings on behalf of users. This API provides calling functionality as well as the ability to create and retrieve online meetings. You can use service applications (bots) with this API, where the bot can act as a participant in your VoIP calls or Microsoft Teams meetings, for example. ## Authorization -One of the following [permissions](/graph/permissions-reference#calls-permissions) is required to access the communications API. These permissions need to be granted by the administrator +One of the following [permissions](/graph/permissions-reference#calls-permissions) is required to access the cloud communications API. These permissions need to be granted by the administrator. | Scenario | Permissions | |:|:| One of the following [permissions](/graph/permissions-reference#calls-permission ## Common use cases -The following table lists some of the common uses for the communications API. +The following table lists some of the common uses for the cloud communications API. | Use cases | REST resources | See also | |:|:|:-|-| Creating and joining 1-1 and group calls | [Call](/graph/api/resources/call?view=graph-rest-v1.0)| [Methods for calls](/graph/api/resources/call?view=graph-rest-v1.0#methods)| -|IVR calls | | [Methods for IVR](/graph/api/resources/calls-api-ivr-overview?view=graph-rest-v1.0) -| Call controls (participant) | [Participant](/graph/api/resources/participant?view=graph-rest-v1.0) || -|Meetings|[onlineMeeting](/graph/api/resources/onlinemeeting?view=graph-rest-v1.0)| [Methods for meetings](/graph/api/resources/onlinemeeting?view=graph-rest-v1.0#methods)| -| Retrieving call records | [callRecord](/graph/api/resources/callrecords-callrecord?view=graph-rest-1.0) | [Webhook subscriptions](/graph/api/resources/webhooks?view=graph-rest-1.0) | -|Presences|[presence](/graph/api/resources/presence?view=graph-rest-v1.0)|| +| Creating and joining 1-1 and group calls | [Call](/graph/api/resources/call?view=graph-rest-v1.0&preserve-view=true)| [Methods for calls](/graph/api/resources/call?view=graph-rest-v1.0&preserve-view=true#methods)| +|IVR calls | | [Methods for IVR](/graph/api/resources/calls-api-ivr-overview?view=graph-rest-v1.0&preserve-view=true) +| Call controls (participant) | [Participant](/graph/api/resources/participant?view=graph-rest-v1.0&preserve-view=true) || +|Meetings|[onlineMeeting](/graph/api/resources/onlinemeeting?view=graph-rest-v1.0&preserve-view=true)| [Methods for meetings](/graph/api/resources/onlinemeeting?view=graph-rest-v1.0&preserve-view=true#methods)| +| Retrieving call records | [callRecord](/graph/api/resources/callrecords-callrecord?view=graph-rest-1.0&preserve-view=true) | [Webhook subscriptions](/graph/api/resources/webhooks?view=graph-rest-1.0&preserve-view=true) | +|Presences|[presence](/graph/api/resources/presence?view=graph-rest-v1.0&preserve-view=true)|| ## Common properties | Resource | Properties | |:|:|-| call | [call properties](/graph/api/resources/call?view=graph-rest-v1.0#properties) | -| participant | [participant properties](/graph/api/resources/participant?view=graph-rest-v1.0#properties) | -| onlineMeeting | [onlineMeeting properties](/graph/api/resources/onlinemeeting?view=graph-rest-v1.0#properties) | -| callRecord | [callRecord properties](/graph/api/resources/callrecords-callrecord#properties) | -|presence|[presence](/graph/api/resources/presence?view=graph-rest-v1.0)| +| call | [call properties](/graph/api/resources/call?view=graph-rest-v1.0&preserve-view=true#properties) | +| participant | [participant properties](/graph/api/resources/participant?view=graph-rest-v1.0&preserve-view=true#properties) | +| onlineMeeting | [onlineMeeting properties](/graph/api/resources/onlinemeeting?view=graph-rest-v1.0&preserve-view=true#properties) | +| callRecord | [callRecord properties](/graph/api/resources/callrecords-callrecord?view=graph-rest-v1.0&preserve-view=true#properties) | +|presence|[presence](/graph/api/resources/presence?view=graph-rest-v1.0&preserve-view=true)| ## What's new Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set. ## See also -- [Communications API samples](https://github.com/microsoftgraph/microsoft-graph-comms-samples/)+- [Cloud communications API samples](https://github.com/microsoftgraph/microsoft-graph-comms-samples/) - [Communication Signaling SDK](https://www.nuget.org/packages/Microsoft.Graph.Communications.Calls) - [Communication Media SDK](https://www.nuget.org/packages/Microsoft.Graph.Communications.Calls.Media) |