Updates from: 05/30/2021 03:04:31
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Accessreviewscheduledefinition List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/accessreviewscheduledefinition-list.md
The following example shows a request to retrieve all the access review series s
"name": "list_accessReviewScheduleDefinition_allgroups" }--> ```msgraph-interactive
-GET https://graph.microsoft.com//beta/identityGovernance/accessReviews/definitions?$filter=contains(scope/microsoft.graph.accessReviewQueryScope/query, './members')
+GET https://graph.microsoft.com/beta/identityGovernance/accessReviews/definitions?$filter=contains(scope/microsoft.graph.accessReviewQueryScope/query, './members')
``` #### Response
v1.0 Chat Get Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-get-members.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /chats/{chat-id}/members/{membership-id}
-GET /users/{user-id}/chats/{chat-id}/members/{membership-id}
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/members/{membership-id}
``` ## Optional query parameters
v1.0 Chat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-get.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /me/chats/{chat-id}
-GET /users/{user-id}/chats/{chat-id}
+GET /users/{user-id | user-principal-name}/chats/{chat-id}
GET /chats/{chat-id} ```
v1.0 Chat List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list-members.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /chats/{chat-id}/members
-GET /users/{user-id}/chats/{chat-id}/members
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/members
``` ## Optional query parameters
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list-messages.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /me/chats/{chat-id}/messages
-GET /users/{user-id}/chats/{chat-id}/messages
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages
GET /chats/{chat-id}/messages ```
v1.0 Chat List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chat-list.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /me/chats
-GET /users/{user-id}/chats
+GET /users/{user-id | user-principal-name}/chats
GET /chats ```
v1.0 Chatmessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessage-get.md
GET /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies/{reply-
<!-- { "blockType": "ignored" } --> ```http GET /chats/{chat-id}/messages/{message-id}
-GET /users/{user-id}/chats/{chat-id}/messages/{message-id}
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id}
GET /me/chats/{chat-id}/messages/{message-id} ```
v1.0 Chatmessage List Hostedcontents https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessage-list-hostedcontents.md
GET /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies/{reply-
<!-- { "blockType": "ignored" } --> ```http GET /chats/{chat-id}/messages/{message-id}/hostedContents
-GET /users/{user-id}/chats/{chat-id}/messages/{message-id}/hostedContents
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id}/hostedContents
``` ## Optional query parameters
v1.0 Chatmessagehostedcontent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chatmessagehostedcontent-get.md
GET /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies/{reply-
<!-- { "blockType": "ignored" } --> ```http GET /chats/{chat-id}/messages/{message-id}/hostedContents/{hosted-content-id}
-GET /users/{user-id}/chats/{chat-id}/messages/{message-id}/hostedContents/{hosted-content-id}
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id}/hostedContents/{hosted-content-id}
``` ## Optional query parameters
v1.0 Chats Getallmessages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/chats-getallmessages.md
The following permissions are required to call this API. To learn more, includin
<!-- { "blockType": "ignored" } --> ```http
-GET /users/{id}/chats/getAllMessages
+GET /users/{id | user-principal-name}/chats/getAllMessages
``` ## Optional query parameters
v1.0 Educationassignment Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationassignment-setupresourcesfolder.md
POST /education/classes/{id}/assignments/{id}/setUpResourcesFolder
## Request headers | Header | Value | |:|:--|
-| Authorization | Bearer {token}. Required. |
+| Authorization | Bearer `{token}`. Required. |
## Request body
-Do not supply a request body for this method.
+You need to provide an empty json `{}` as request body for this method.
## Response If successful, this method returns a 200 Ok response code and [educationAssignment](/graph/api/resources/educationAssignment?view=graph-rest-beta&preserve-view=true) object in the request body. ## Example The following example shows how to call this API.+ ### Request The following is an example of a request.
The following is an example of a request.
}--> ```msgraph-interactive POST https://graph.microsoft.com/beta/education/classes/11012/assignments/19002/setUpResourcesFolder
+Content-type: application/json
+
+{
+}
``` - ### Response The following is an example of a response.
v1.0 Educationsubmission Setupresourcesfolder https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/educationsubmission-setupResourcesFolder.md
POST /education/classes/{id}/assignments/{id}/submissions/{id}/setUpResourcesFol
## Request headers | Header | Value | |:|:--|
-| Authorization | Bearer {token}. Required. |
+| Authorization | Bearer `{token}`. Required. |
## Request body
-Do not supply a request body for this method.
+Provide an empty json `{}` as request body for this method.
+ ## Response If successful, this method returns a `200 Ok` response code. The body will contain the submission model. ## Example The following example shows how to call this API.+ ### Request The following is an example of a request. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "educationsubmission_setupresourcesfolder" }--> ```msgraph-interactive POST https://graph.microsoft.com/beta/education/classes/11012/assignments/19002/submissions/20302/setUpResourcesFolder
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--
+Content-type: application/json
+{
+}
+```
- ### Response The following is an example of a response.
v1.0 Serviceprincipal Delete Approleassignedto https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-delete-approleassignedto.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-DELETE /servicePrincipals/{id}/appRoleAssignedTo/{id}
+DELETE /servicePrincipals/{resource-SP-id}/appRoleAssignedTo/{principal-id}
``` > [!NOTE]
If successful, this method returns `204 No Content` response code. It does not r
Here is an example of the request to delete an app role assignment from the resource service principal. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceprincipal_delete_approleassignedto"
Here is an example of the request to delete an app role assignment from the reso
```http DELETE https://graph.microsoft.com/beta/servicePrincipals/{resource-SP-id}/appRoleAssignedTo/{principal-id} ```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-- In this example, `{resource-SP-id}` would be the id of the resource service principal, and `{principalId}` would be the id of the assigned user, group, or client service principal.
v1.0 Serviceprincipal Delete Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/serviceprincipal-delete-approleassignments.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-DELETE /servicePrincipals/{id}/appRoleAssignments/{id}
+DELETE /servicePrincipals/{servicePrincipal-id}/appRoleAssignments/{appRoleAssignment-id}
``` > [!NOTE]
If successful, this method returns `204 No Content` response code. It does not r
Here is an example of the request to delete an app role assignment. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceprincipal_delete_approleassignment" }--> ```http
-DELETE https://graph.microsoft.com/beta/servicePrincipals/{id}/appRoleAssignments/{id}
+DELETE https://graph.microsoft.com/beta/servicePrincipals/{servicePrincipal-id}/appRoleAssignments/{appRoleAssignment-id}
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
v1.0 User List Joinedteams https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-joinedteams.md
One of the following permissions is required to call this API. To learn more, in
```http GET /me/joinedTeams or
-GET /users/{id}/joinedTeams
+GET /users/{id | user-principal-name}/joinedTeams
``` ## Optional query parameters
v1.0 User List Ownedobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list-ownedobjects.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All |
+|Delegated (work or school account) | User.Read, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All |
|Delegated (personal Microsoft account) | Not supported. | |Application | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/user-list.md
GET /users
This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, and `$filter`. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index. The `$count` and `$search` parameters are currently not available in Azure AD B2C tenants.
+Certain properties cannot be returned within a user collection. The following properties are only supported when [retrieving a single user](./user-get.md): **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **mailboxSettings**.
+
+The following properties are not supported in personal Microsoft accounts and will be `null`: **aboutMe**, **birthday**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **streetAddress**.
+ ## Request headers | Header | Value |
v1.0 Userscopeteamsappinstallation Get Chat https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/userscopeteamsappinstallation-get-chat.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /users/{user-id}/teamwork/installedApps/{app-installation-id}/chat
+GET /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}/chat
``` ## Optional query parameters
v1.0 Userteamwork Delete Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/userteamwork-delete-installedapps.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-DELETE /users/{user-id}/teamwork/installedApps/{app-installation-id}
+DELETE /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
``` ## Request headers
v1.0 Userteamwork Get Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/userteamwork-get-installedapps.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /users/{user-id}/teamwork/installedApps/{app-installation-id}
+GET /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
``` ## Request headers
v1.0 Userteamwork List Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/userteamwork-list-installedapps.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /users/{user-id}/teamwork/installedApps
+GET /users/{user-id | user-principal-name}/teamwork/installedApps
``` ## Optional query parameters
v1.0 Userteamwork Post Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/userteamwork-post-installedapps.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /users/{user-id}/teamwork/installedApps
+POST /users/{user-id | user-principal-name}/teamwork/installedApps
``` ## Request headers
v1.0 Userteamwork Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/userteamwork-sendactivitynotification.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /users/{userId}/teamwork/sendActivityNotification
+POST /users/{userId | user-principal-name}/teamwork/sendActivityNotification
``` ## Request headers
v1.0 Userteamwork Teamsappinstallation Upgrade https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/userteamwork-teamsappinstallation-upgrade.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /users/{user-id}/teamwork/installedApps/{app-installation-id}/upgrade
+POST /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}/upgrade
``` ## Request headers
v1.0 Dynamics Employee https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/dynamics-employee.md
Represents an employee in Dynamics 365 Business Central.
|givenName |string |The given name of the employee. | |middleName |string |The middle name of the employee. | |surname |string |The surname of the employee |
-|jobTitle |string |The full name of the employee |
+|jobTitle |string |The job title of the employee |
|address |[NAV.PostalAddress](../resources/dynamics-complextypes.md)|Specifies the employee's address. This address will appear on all resource documents for the employee.| |phoneNumber |string |Specifies the employee's telephone number. | |mobilePhone |string |Specifies the employee's mobile telephone number. |
v1.0 Organization https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/organization.md
This resource lets you add your own data to custom properties using [extensions]
|**Schema extensions**| | | |[Add schema extension values](../api/schemaextension-post-schemaextensions.md) | [schemaExtension](schemaextension.md) | Create a schema extension definition and then use it to add custom typed data to a resource.| |[Create organizationalBrandingProperties](../api/organizationalbrandingproperties-create.md) | [organizationalBrandingProperties](organizationalbrandingproperties.md) | Create a new organizationalBrandingProperties by posting to the branding collection. |
-|[Get branding](../api/organizationalbrandingproperties-get.md) | [organizationalBrandingProperties](organizationalbrandingproperties.md) collection | Get a organizationalBrandingProperties object collection. |
+|[Get branding](../api/organizationalbrandingproperties-get.md) | [organizationalBrandingProperties](organizationalbrandingproperties.md) collection | Get an organizationalBrandingProperties object collection. |
## Properties | Property | Type | Description |
This resource lets you add your own data to custom properties using [extensions]
| isMultipleDataLocationsForServicesEnabled | Boolean | `true` if organization is Multi-Geo enabled; `false` if organization is not Multi-Geo enabled; `null` (default). Read-only. For more information, see [OneDrive Online Multi-Geo](/sharepoint/dev/solution-guidance/multigeo-introduction). | | marketingNotificationEmails | String collection | Not nullable. | | objectType | String | A string that identifies the object type. For tenants the value is always `Company`.|
-| onPremisesLastSyncDateTime | DateTimeOffset | The time and date at which the tenant was last synced with the on-premise directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
+| onPremisesLastSyncDateTime | DateTimeOffset | The time and date at which the tenant was last synced with the on-premises directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`.|
| onPremisesSyncEnabled | Boolean | `true` if this object is synced from an on-premises directory; `false` if this object was originally synced from an on-premises directory but is no longer synced; Nullable. `null` if this object has never been synced from an on-premises directory (default). | | postalCode | String | Postal code of the address for the organization. | | preferredLanguage | String | The preferred language for the organization. Should follow ISO 639-1 Code; for example `en`. |
v1.0 Termstore Localizedlabel https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/termstore-localizedlabel.md
Identifies the labels associated with a given term.
|Property|Type|Description| |:|:|:| |isDefault|Boolean|Indicates whether the label is the default label.|
-|languageTag|String|The anguage tag for the label.|
+|languageTag|String|The language tag for the label.|
|name|String|The name of the label.| ## Relationships
v1.0 Chat Get Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chat-get-members.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /chats/{chat-id}/members/{membership-id}
-GET /users/{user-id}/chats/{chat-id}/members/{membership-id}
+GET /users/{user-id} | user-principal-name/chats/{chat-id}/members/{membership-id}
``` ## Optional query parameters
v1.0 Chat Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chat-get.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /me/chats/{chat-id}
-GET /users/{user-id}/chats/{chat-id}
+GET /users/{user-id | user-principal-name}/chats/{chat-id}
GET /chats/{chat-id} ```
v1.0 Chat List Members https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chat-list-members.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /chats/{chat-id}/members
-GET /users/{user-id}/chats/{chat-id}/members
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/members
``` ## Optional query parameters
v1.0 Chat List Messages https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chat-list-messages.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http GET /me/chats/{chat-id}/messages
-GET /users/{user-id}/chats/{chat-id}/messages
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages
GET /chats/{chat-id}/messages ```
v1.0 Chatmessage Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chatmessage-get.md
GET /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies/{reply-
<!-- { "blockType": "ignored" } --> ```http GET /chats/{chat-id}/messages/{message-id}
-GET /users/{user-id}/chats/{chat-id}/messages/{message-id}
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id}
GET /me/chats/{chat-id}/messages/{message-id} ```
v1.0 Chatmessage List Hostedcontents https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chatmessage-list-hostedcontents.md
GET /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies/{reply-
<!-- { "blockType": "ignored" } --> ```http GET /chats/{chat-id}/messages/{message-id}/hostedContents
-GET /users/{user-id}/chats/{chat-id}/messages/{message-id}/hostedContents
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id}/hostedContents
``` ## Optional query parameters
v1.0 Chatmessagehostedcontent Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/chatmessagehostedcontent-get.md
GET /teams/{team-id}/channels/{channel-id}/messages/{message-id}/replies/{reply-
<!-- { "blockType": "ignored" } --> ```http GET /chats/{chat-id}/messages/{message-id}/hostedContents/{hosted-content-id}
-GET /users/{user-id}/chats/{chat-id}/messages/{message-id}/hostedContents/{hosted-content-id}
+GET /users/{user-id | user-principal-name}/chats/{chat-id}/messages/{message-id}/hostedContents/{hosted-content-id}
``` ## Optional query parameters
v1.0 Serviceprincipal Delete Approleassignedto https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceprincipal-delete-approleassignedto.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-DELETE /servicePrincipals/{id}/appRoleAssignedTo/{id}
+DELETE /servicePrincipals/{resource-SP-id}/appRoleAssignedTo/{principal-id}
``` > [!NOTE]
If successful, this method returns `204 No Content` response code. It does not r
Here is an example of the request to delete an app role assignment from the resource service principal. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceprincipal_delete_approleassignedto" }--> ```http
-DELETE https://graph.microsoft.com/v1.0/servicePrincipals/{id}/appRoleAssignedTo/{id}
+DELETE https://graph.microsoft.com/v1.0/servicePrincipals/{resource-SP-id}/appRoleAssignedTo/{principalId}
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
-- In this example, `{resource-SP-id}` would be the id of the resource service principal, and `{principalId}` would be the id of the assigned user, group, or client service principal.
v1.0 Serviceprincipal Delete Approleassignments https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/serviceprincipal-delete-approleassignments.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-DELETE /servicePrincipals/{id}/appRoleAssignments/{id}
+DELETE /servicePrincipals/{servicePrincipal-id}/appRoleAssignments/{appRoleAssignment-id}
``` > [!NOTE]
If successful, this method returns `204 No Content` response code. It does not r
Here is an example of the request to delete an app role assignment. -
-# [HTTP](#tab/http)
<!-- { "blockType": "request", "name": "serviceprincipal_delete_approleassignment" }--> ```http
-DELETE https://graph.microsoft.com/v1.0/servicePrincipals/{id}/appRoleAssignments/{id}
+DELETE https://graph.microsoft.com/v1.0/servicePrincipals/{servicePrincipal-id}/appRoleAssignments/{appRoleAssignment-id}
```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
--- ### Response
-The following is an example of the response.
- <!-- { "blockType": "response", "truncated": true
v1.0 User List Joinedteams https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-list-joinedteams.md
One of the following permissions is required to call this API. To learn more, in
```http GET /me/joinedTeams or
-GET /users/{id}/joinedTeams
+GET /users/{id | user-principal-name}/joinedTeams
``` ## Optional query parameters
v1.0 User List Ownedobjects https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-list-ownedobjects.md
One of the following permissions is required to call this API. To learn more, in
|Permission type | Permissions (from least to most privileged) | |:--|:|
-|Delegated (work or school account) | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All |
+|Delegated (work or school account) | User.Read, User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All, Directory.AccessAsUser.All |
|Delegated (personal Microsoft account) | Not supported. | |Application | User.Read.All, User.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All |
v1.0 User List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/user-list.md
GET /users
This method supports the [OData query parameters](/graph/query-parameters) to help customize the response, including `$search`, `$count`, `$filter`, and `$select`. You can use `$search` on the **displayName** property. When items are added or updated for this resource, they are specially indexed for use with the `$count` and `$search` query parameters. There can be a slight delay between when an item is added or updated and when it is available in the index. The `$count` and `$search` parameters are currently not available in Azure AD B2C tenants. By default, only a limited set of properties are returned (**businessPhones**, **displayName**, **givenName**, **id**, **jobTitle**, **mail**, **mobilePhone**, **officeLocation**, **preferredLanguage**, **surname**, and **userPrincipalName**). - To return an alternative property set, specify the desired set of [user](../resources/user.md) properties using the OData `$select` query parameter. For example, to return **displayName**, **givenName**, and **postalCode**, add the following to your query `$select=displayName,givenName,postalCode`.
-Certain properties cannot be returned within a user collection. The following properties are only supported when [retrieving an single user](./user-get.md): **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **mailboxSettings**.
+Certain properties cannot be returned within a user collection. The following properties are only supported when [retrieving a single user](./user-get.md): **aboutMe**, **birthday**, **hireDate**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **mailboxSettings**.
+
+The following properties are not supported in personal Microsoft accounts and will be `null`: **aboutMe**, **birthday**, **interests**, **mySite**, **pastProjects**, **preferredName**, **responsibilities**, **schools**, **skills**, **streetAddress**.
## Request headers
v1.0 Userscopeteamsappinstallation Get Chat https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/userscopeteamsappinstallation-get-chat.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /users/{user-id}/teamwork/installedApps/{app-installation-id}/chat
+GET /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}/chat
``` ## Optional query parameters
v1.0 Userteamwork Delete Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/userteamwork-delete-installedapps.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-DELETE /users/{user-id}/teamwork/installedApps/{app-installation-id}
+DELETE /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
``` ## Request headers
v1.0 Userteamwork Get Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/userteamwork-get-installedapps.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /users/{user-id}/teamwork/installedApps/{app-installation-id}
+GET /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}
``` ## Request headers
v1.0 Userteamwork List Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/userteamwork-list-installedapps.md
One of the following permissions is required to call this API. To learn more, in
<!-- { "blockType": "ignored" } --> ```http
-GET /users/{user-id}/teamwork/installedApps
+GET /users/{user-id | user-principal-name}/teamwork/installedApps
``` ## Optional query parameters
v1.0 Userteamwork Post Installedapps https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/userteamwork-post-installedapps.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /users/{user-id}/teamwork/installedApps
+POST /users/{user-id | user-principal-name}/teamwork/installedApps
``` ## Request headers
v1.0 Userteamwork Sendactivitynotification https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/userteamwork-sendactivitynotification.md
One of the following permissions is required to call this API. To learn more, in
} --> ``` http
-POST /users/{userId}/teamwork/sendActivityNotification
+POST /users/{userId | user-principal-name}/teamwork/sendActivityNotification
``` ## Request headers
v1.0 Userteamwork Teamsappinstallation Upgrade https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/userteamwork-teamsappinstallation-upgrade.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /users/{user-id}/teamwork/installedApps/{app-installation-id}/upgrade
+POST /users/{user-id | user-principal-name}/teamwork/installedApps/{app-installation-id}/upgrade
``` ## Request headers
v1.0 Entity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/entity.md
Here is a JSON representation of the resource
{ "id": "string (identifier)" }- ``` <!-- uuid: 8fcb5dbc-d5aa-4681-8e31-b001d5168d79
v1.0 Organization https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/organization.md
This resource lets you add your own data to custom properties using [extensions]
|[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.| |**Schema extensions**| |[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
-| [Get branding](../api/organizationalbrandingproperties-get.md) | [organizationalBrandingProperties](organizationalbrandingproperties.md) collection | Get a organizationalBrandingProperties object collection. |
+| [Get branding](../api/organizationalbrandingproperties-get.md) | [organizationalBrandingProperties](organizationalbrandingproperties.md) collection | Get an organizationalBrandingProperties object collection. |
## Properties
This resource lets you add your own data to custom properties using [extensions]
| countryLetterCode | String | Country/region abbreviation for the organization. | | createdDateTime | DateTimeOffset | Timestamp of when the organization was created. The value cannot be modified and is automatically populated when the organization is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. | | deletedDateTime | DateTimeOffset | Represents date and time of when the Azure AD tenant was deleted using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. |
-| createdDateTime | DateTimeOffset | Timestamp of when the organization was created. The value cannot be modified and is automatically populated when the organization is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. |
| displayName | String | The display name for the tenant. | | id | String | The tenant ID, a unique identifier representing the organization (or tenant). Inherited from [directoryObject](directoryobject.md). Key. Not nullable. Read-only. | | isMultipleDataLocationsForServicesEnabled | Boolean | `true` if organization is Multi-Geo enabled; **false** if organization is not Multi-Geo enabled; **null** (default). Read-only. For more information, see [OneDrive Online Multi-Geo](/sharepoint/dev/solution-guidance/multigeo-introduction). | | marketingNotificationEmails | String collection | Not nullable. |
-| onPremisesLastSyncDateTime | DateTimeOffset | The time and date at which the tenant was last synced with the on-premise directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.|
+| onPremisesLastSyncDateTime | DateTimeOffset | The time and date at which the tenant was last synced with the on-premises directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only.|
| onPremisesSyncEnabled | Boolean | `true` if this object is synced from an on-premises directory; `false` if this object was originally synced from an on-premises directory but is no longer synced. Nullable. `null` if this object has never been synced from an on-premises directory (default). | | postalCode | String | Postal code of the address for the organization. |
-| preferredLanguage | String | The preferred language for the organization. Should follow ISO 639-1 Code; for example `en`. |
+| preferredLanguage | String | The preferred language for the organization. Should follow ISO 639-1 Code; for example, `en`. |
| privacyProfile | [privacyProfile](privacyprofile.md) | The privacy profile of an organization. | | provisionedPlans | [ProvisionedPlan](provisionedplan.md) collection | Not nullable. | | securityComplianceNotificationMails | String collection ||
v1.0 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
href: api/application-removekey.md - name: Extensions items:
- - name: List
- href: api/application-list-extensionproperty.md
- - name: Create
- href: api/application-post-extensionproperty.md
- - name: Delete
- href: api/application-delete-extensionproperty.md
+ - name: Extension property
+ href: resources/extensionproperty.md
+ items:
+ - name: List
+ href: api/application-list-extensionproperty.md
+ - name: Create
+ href: api/application-post-extensionproperty.md
+ - name: Delete
+ href: api/application-delete-extensionproperty.md
- name: Owners items: - name: List