Updates from: 09/24/2021 03:17:48
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Device Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-delete.md
One of the following permissions is required to call this API. To learn more, in
|Application | Not supported. | ## HTTP request+
+The `{id}` in the request is the value of the **id** property of the device, not the **deviceId** property.
<!-- { "blockType": "ignored" } --> ```http DELETE /devices/{id} ```
-> Note: The "id" in the request is the "id" property of the device, not the "deviceId" property.
## Request headers | Name | Type | Description|
v1.0 Device Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-get.md
One of the following permissions is required to call this API. To learn more, in
|Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | ## HTTP request+
+The `{id}` in the request is the value of the **id** property of the device, not the **deviceId** property.
<!-- { "blockType": "ignored" } --> ```http GET /devices/{id}
v1.0 Device Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/device-update.md
One of the following permissions is required to call this API. To learn more, in
|Application | Device.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request+
+The `{id}` in the request is the value of the **id** property of the device, not the **deviceId** property.
+ <!-- { "blockType": "ignored" } --> ```http PATCH /devices/{id} ```
-> Note: The "id" in the request is the "id" property of the device, not the "deviceId" property.
- ## Request headers | Name | Type | Description| |:--|:|:-|
In the request body, supply the values for the [device](../resources/device.md)
| Property | Type |Description| |:|:--|:-|
-|accountEnabled|Boolean| **true** if the account is enabled; otherwise, **false**. |
+|accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. Only callers in Global Administrator and Cloud Device Administrator roles can update this property. |
|operatingSystem|String|The type of operating system on the device.| |operatingSystemVersion|String|The version of the operating system on the device| |displayName|String|The display name for the device.|
-|isCompliant|Boolean|**true** if the device complies with Mobile Device Management (MDM) policies; otherwise, **false**. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
-|isManaged|Boolean|**true** if the device is managed by a Mobile Device Management (MDM) app; otherwise, **false**. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
+|isCompliant|Boolean|`true` if the device complies with Mobile Device Management (MDM) policies; otherwise, `false`. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
+|isManaged|Boolean|`true` if the device is managed by a Mobile Device Management (MDM) app; otherwise, `false`. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
Since the **device** 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 **device** instance.
v1.0 Directoryaudit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directoryaudit-list.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) | AuditLog.Read.All and Directory.Read.All |
-|Delegated (personal Microsoft account) | Not supported |
+|Delegated (personal Microsoft account) | Not supported. |
|Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
v1.0 Organizationalbranding Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbranding-delete.md
+
+ Title: "Delete organizationalBranding"
+description: "Deletes an organizationalBranding object."
+
+ms.localizationpriority: medium
++
+# Delete organizationalBranding
+Namespace: microsoft.graph
++
+Delete the default organizational branding object. To delete the [organizationalBranding](../resources/organizationalbranding.md) object, all images (Stream types) must first be removed from the object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+|Permission type|Permissions (from least to most privileged)|
+|:|:|
+|Delegated (work or school account)|Organization.ReadWrite.All|
+|Delegated (personal Microsoft account)|Not supported.|
+|Application|Not supported.|
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /organization/{organizationId}/branding
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+
+In the request body, supply a JSON representation of the default [organizationalBranding](../resources/organizationalbranding.md) object. only the **id** property is required.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+<!-- {
+ "blockType": "request",
+ "name": "delete_organizationalbranding"
+}
+-->
+``` http
+DELETE https://graph.microsoft.com/beta/organization/84841066-274d-4ec0-a5c1-276be684bdd3/branding
+
+{
+ "id": "0"
+}
+```
++
+### Response
+
+The following is an example of the response.
+<!-- {
+ "blockType": "response",
+ "truncated": true
+}
+-->
+``` http
+HTTP/1.1 204 No Content
+```
+
v1.0 Organizationalbranding Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbranding-get.md
+
+ Title: "Get organizationalBranding"
+description: "Read the properties and relationships of an organizationalBranding object."
+
+ms.localizationpriority: medium
++
+# Get organizationalBranding
+Namespace: microsoft.graph
++
+Retrieve the default organizational branding object, if the **Accept-Language** header is not specified. If no organizational branding object has been created, this method returns a `404 Not Found` error.
+
+If the **Accept-Language** header is specified, this method retrieves the branding for the specified locale.
+
+This method retrieves only non-Stream properties, for example, **usernameHintText** and **signInPageText**. To retrieve Stream types of the default branding, for example, **bannerLogo** and **backgroundImage**, use the [GET organizationalBrandingLocalization](organizationalbrandinglocalization-get.md) method. The **id** for the default localization can be `0` or `default`.
+
+## 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) | User.Read, Organization.Read.All, User.ReadBasic.All, User.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /organization/{organizationId}/branding
+```
+
+## Optional query parameters
+
+This method supports only the `$select` OData query parameter to help customize the response. For general information, see [OData query parameters](/graph/query-parameters).
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Accept-Language|A valid ISO 639-1 locale. Optional.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `200 OK` response code and an [organizationalBranding](../resources/organizationalbranding.md) object in the response body. If no default branding object exists, this method returns a `404 Not Found` response code.
+
+## Examples
+
+### Example 1: Get the default branding
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbranding"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/organization/84841066-274d-4ec0-a5c1-276be684bdd3/branding
+```
+
+#### 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.organizationalBranding"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#branding",
+ "@odata.id": "https://graph.microsoft.com/v2/99b24e1b-abec-4598-9d63-a2baf0a3cea1/directoryObjects/$/Microsoft.DirectoryServices.Organization('99b24e1b-abec-4598-9d63-a2baf0a3cea1')/branding/0",
+ "id": "0",
+ "backgroundColor": "",
+ "backgroundImageRelativeUrl": "c1c6b6c8-urr-dzbkz44n5kuo9kzl1kziuujjcdqonoe2owyacso/logintenantbranding/0/illustration?ts=637535563816027796",
+ "bannerLogoRelativeUrl": "c1c6b6c8-urr-dzbkz44n5kuo9kzl1kziuujjcdqonoe2owyacso/logintenantbranding/0/bannerlogo?ts=637535563824629275",
+ "cdnList": [
+ "secure.aadcdn.microsoftonline-p.com",
+ "aadcdn.msftauthimages.net",
+ "aadcdn.msauthimages.net"
+ ],
+ "signInPageText": "Contoso",
+ "squareLogoRelativeUrl": "c1c6b6c8-urr-dzbkz44n5kuo9kzl1kziuujjcdqonoe2owyacso/logintenantbranding/0/tilelogo?ts=637535563832888580",
+ "usernameHintText": ""
+}
+```
++
+### Example 2: Get organizational branding when no branding is configured
+
+#### Request
+
+The following is an example of the request.
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbranding_Error"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response"
+} -->
+
+```http
+HTTP/1.1 404 Not Found
+```
+
+### Example 3: Get organizational branding for the French locale
+
+In the following example, the **Accept-Language** header is used specify the localization branding to retrieve.
+
+#### Request
+
+The following is an example of the request.
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbranding_locale"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
+Accept-Language: fr-FR
+```
+
+#### 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.organizationalBranding"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#branding",
+ "@odata.id": "https://graph.microsoft.com/v2/84841066-274d-4ec0-a5c1-276be684bdd3/directoryObjects/$/Microsoft.DirectoryServices.Organization('84841066-274d-4ec0-a5c1-276be684bdd3')/branding/fr",
+ "id": "fr",
+ "backgroundColor": "#FFFF33",
+ "backgroundImageRelativeUrl": null,
+ "bannerLogoRelativeUrl": null,
+ "cdnList": [],
+ "signInPageText": " ",
+ "squareLogoRelativeUrl": null,
+ "usernameHintText": " "
+}
+```
+
+### Example 4: Get the bannerLogo for the default locale
+
+The following example returns the **bannerLogo** object for the default locale. You may specify the **id** as `default` or `0` in the request URL. If the object is not set, the request returns an empty response.
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "ignored",
+ "name": "get_organizationalbranding_defaultlocale_bannerLogo"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/default/bannerLogo
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBranding"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-Type: image/*
+
+<Image>
+```
+
+### Example 5: Get the bannerLogo for the fr-FR locale
+
+The following example returns the **bannerLogo** object for the `fr-FR` locale whose bannerLogo is not set.
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbranding_frlocale_bannerLogo"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/default/bannerLogo
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBranding"
+} -->
+
+```http
+HTTP/1.1 200 OK
+
+{}
+```
v1.0 Organizationalbranding List Localizations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbranding-list-localizations.md
+
+ Title: "List localizations"
+description: "Get the organizationalBrandingLocalization resources from the localizations navigation property."
+
+ms.localizationpriority: medium
++
+# List localizations
+Namespace: microsoft.graph
++
+Retrieve all localization branding objects, including the default branding.
+
+## 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) | User.Read, Organization.Read.All, User.ReadBasic.All, User.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /organization/{organizationId}/branding/localizations
+```
+
+## Optional query parameters
+This method supports only the `$select` OData query parameter 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 [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) objects in the response body.
+
+## Examples
+
+### Request
+
+The following is an example of the request.
+<!-- {
+ "blockType": "request",
+ "name": "list_organizationalbrandinglocalization"
+}
+-->
+``` http
+GET https://graph.microsoft.com/beta/organization/84841066-274d-4ec0-a5c1-276be684bdd3/branding/localizations/
+```
+
+### Response
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "Collection(microsoft.graph.organizationalBrandingLocalization)"
+}
+-->
+``` http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#organization('84841066-274d-4ec0-a5c1-276be684bdd3')/branding/localizations",
+ "value": [
+ {
+ "@odata.id": "https://graph.microsoft.com/v2/84841066-274d-4ec0-a5c1-276be684bdd3/directoryObjects/$/Microsoft.DirectoryServices.Organization('84841066-274d-4ec0-a5c1-276be684bdd3')//localizations/0",
+ "id": "0",
+ "backgroundColor": "",
+ "backgroundImageRelativeUrl": "c1c6b6c8-ctwpxrbizfcsectmtir3yvna3hrhaib9j7ueqv0ldne/logintenantbranding/0/illustration?ts=637635061764954395",
+ "bannerLogoRelativeUrl": "c1c6b6c8-ctwpxrbizfcsectmtir3yvna3hrhaib9j7ueqv0ldne/logintenantbranding/0/bannerlogo?ts=637635061773126717",
+ "cdnList": [
+ "secure.aadcdn.microsoftonline-p.com",
+ "aadcdn.msftauthimages.net",
+ "aadcdn.msauthimages.net"
+ ],
+ "signInPageText": "Contoso",
+ "squareLogoRelativeUrl": "c1c6b6c8-ctwpxrbizfcsectmtir3yvna3hrhaib9j7ueqv0ldne/logintenantbranding/0/tilelogo?ts=637635061781098977",
+ "usernameHintText": ""
+ },
+ {
+ "@odata.id": "https://graph.microsoft.com/v2/84841066-274d-4ec0-a5c1-276be684bdd3/directoryObjects/$/Microsoft.DirectoryServices.Organization('84841066-274d-4ec0-a5c1-276be684bdd3')//localizations/fr",
+ "id": "fr",
+ "backgroundColor": "#FFFF33",
+ "backgroundImageRelativeUrl": null,
+ "bannerLogoRelativeUrl": null,
+ "cdnList": [],
+ "signInPageText": "Welcome",
+ "squareLogoRelativeUrl": null,
+ "usernameHintText": "hint"
+ }
+ ]
+}
+```
+
v1.0 Organizationalbranding Post Localizations https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbranding-post-localizations.md
+
+ Title: "Create organizationalBrandingLocalization"
+description: "Create a new organizationalBrandingLocalization object."
+
+ms.localizationpriority: medium
++
+# Create organizationalBrandingLocalization
+Namespace: microsoft.graph
++
+Create a new [organizationalBrandingLocalization](../resources/organizationalBrandingLocalization.md) object. This creates a localized branding and at the same time, the default branding if it doesn't exist.
+
+The default branding is created only once. It's loaded when a localized branding isn't configured for the user's browser language. To retrieve the default branding, see [Get branding](organizationalbranding-get.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) | Organization.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+This request creates a new localization branding and a default branding if one does not already exist.
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+POST /organization/{organizationId}/branding/localizations
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+
+The following table shows the properties that are required when you create the [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) object.
+
+| Property | Type | Description |
+|:-|:|:|
+| id | String | An identifier that represents the locale specified in the ISO 639-1 standard, for example English is `en-US`. You can't create the default branding by setting the value of **id** to the String types `0` or `default`. <br/><br/>**NOTE:** Multiple branding for a single locale are currently not supported. |
+
+## Response
+
+If successful, this method returns a `201 Created` response code and an [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) object in the response body.
+
+## Examples
+
+The following example creates a branding localization for French (`fr-FR`) localization. Any unspecified properties of the String type inherit from the value in the default branding object. For example, if the signInPageText in the default branding object is `null`, the signInPageText for the `fr-FR` branding created in this request will also be `null`. To override a `null` value without any text, use a string containing only whitespace.
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "create_organizationalbrandinglocalization"
+}-->
+```http
+POST https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations
+Content-Type: application/json
+
+{
+ "backgroundColor":"#00000F",
+ "id": "fr-FR",
+ "signInPageText": " "
+}
+```
++
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingLocalization"
+} -->
+
+```http
+HTTP/1.1 201 Created
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#organization('d69179bf-f4a4-41a9-a9de-249c0f2efb1d')/branding/localizations/$entity",
+ "@odata.id": "https://graph.microsoft.com/v2/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/directoryObjects/$/Microsoft.DirectoryServices.Organization('d69179bf-f4a4-41a9-a9de-249c0f2efb1d')//localizations/fr-FR",
+ "id": "fr-FR",
+ "backgroundColor": "",
+ "backgroundImageRelativeUrl": null,
+ "bannerLogoRelativeUrl": null,
+ "cdnList": [],
+ "signInPageText": " ",
+ "squareLogoRelativeUrl": null,
+ "usernameHintText": ""
+}
+```
v1.0 Organizationalbranding Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbranding-update.md
+
+ Title: "Update organizationalBranding"
+description: "Update the properties of an organizationalBranding object."
+
+ms.localizationpriority: medium
++
+# Update organizationalBranding
+Namespace: microsoft.graph
++
+Update the properties of the default branding object specified by the [organizationalBranding](../resources/organizationalbranding.md) object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | Organization.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /organization/{organizationId}/branding
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+|Accept-Language|A valid ISO 639-1 locale. Required.|
+
+## Request body
+In the request body, supply *only* the values for properties that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values.
+
+The following table specifies the properties that can be updated.
+
+| Property | Type | Description |
+|:-|:|:|
+| backgroundColor | String | Color that will appear in place of the background image in low-bandwidth connections. We recommend that you use the primary color of your banner logo or your organization color. Specify this in hexadecimal format, for example, white is `#FFFFFF`. |
+| backgroundImage | Stream | Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image will reduce bandwidth requirements and make the page load faster. |
+| bannerLogo | Stream | A banner version of your company logo that appears on the sign-in page. The allowed types are PNG or JPEG no larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo. |
+| signInPageText | String | Text that appears at the bottom of the sign-in box. You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be Unicode and not exceed 1024 characters. |
+| squareLogo | Stream | A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG no larger than 240 x 240 pixels and no more than 10 KB in size. We recommend using a transparent image with no padding around the logo. |
+| usernameHintText | String | String that shows as the hint in the username textbox on the sign-in screen. This text must be a Unicode, without links or code, and can't exceed 64 characters. |
++
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Example 1: Update the default branding
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_organizationalbrandinglocaliation_1"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
+Content-Type: application/json
+
+{
+ "signInPageText":"Default",
+ "usernameHintText":"DefaultHint"
+}
+```
++
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response"
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+### Example 2: Update bannerLogo for default branding
+
+The following request updates the banner logo for the default branding.
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_organizationalbrandinglocaliation_2"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo
+Content-Type: image/jpeg
+
+<Image>
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response"
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
v1.0 Organizationalbrandinglocalization Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandinglocalization-delete.md
+
+ Title: "Delete organizationalBrandingLocalization"
+description: "Deletes an organizationalBrandingLocalization object."
+
+ms.localizationpriority: medium
++
+# Delete organizationalBrandingLocalization
+Namespace: microsoft.graph
++
+Delete a localized branding object. To delete the [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) object, all images (Stream types) must first be removed from the object.
+
+## Permissions
+One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
+
+| Permission type | Permissions (from least to most privileged) |
+|:|:--|
+| Delegated (work or school account) | Organization.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+DELETE /organization/{organizationId}/branding/localizations/{organizationalBrandingLocalizationId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+
+## Request body
+Do not supply a request body for this method.
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Request
+
+The following is an example of a request to delete the `fr-FR` localization object.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_organizationalbrandinglocalization"
+}-->
+
+```http
+DELETE https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr-FR
+```
++
+### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
v1.0 Organizationalbrandinglocalization Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandinglocalization-get.md
+
+ Title: "Get organizationalBrandingLocalization"
+description: "Read the properties and relationships of an organizationalBrandingLocalization object."
+
+ms.localizationpriority: medium
++
+# Get organizationalBrandingLocalization
+Namespace: microsoft.graph
++
+Read the properties and relationships of an [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) object. To retrieve a localization branding object, specify the value of **id** in the URL.
+
+## 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) | User.Read, Organization.Read.All, User.ReadBasic.All, User.Read.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+GET /organization/{organizationId}/branding/localizations/{organizationalBrandingLocalizationId}
+```
+
+## 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 [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) object in the response body.
+
+## Examples
+
+### Example 1: Get the localized branding for a specific locale (fr-FR)
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbrandinglocalization"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr-FR
+```
++
+#### 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.organizationalBrandingLocalization"
+} -->
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#organization('99b24e1b-abec-4598-9d63-a2baf0a3cea1')/branding/localizations/$entity",
+ "@odata.type": "#microsoft.graph.organizationalBrandingProperties",
+ "@odata.id": "https://graph.microsoft.com/v2/99b24e1b-abec-4598-9d63-a2baf0a3cea1/directoryObjects/$/Microsoft.DirectoryServices.Organization('99b24e1b-abec-4598-9d63-a2baf0a3cea1')//localizations('fr-FR')/fr-FR",
+ "id": "fr-FR",
+ "backgroundColor": "",
+ "backgroundImageRelativeUrl": null,
+ "bannerLogoRelativeUrl": "c1c6b6c8-urr-dzbkz44n5kuo9kzl1kziuujjcdqonoe2owyacso/logintenantbranding/1036/bannerlogo?ts=637673868626068858",
+ "cdnList": [
+ "secure.aadcdn.microsoftonline-p.com",
+ "aadcdn.msftauthimages.net",
+ "aadcdn.msauthimages.net"
+ ],
+ "signInPageText": "Welcome to Contoso France",
+ "usernameHintText": "Welcome to Contoso France"
+}
+```
+
+### Example 2: Get the value of signInPageText for a specific locale
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbrandinglocalization_locale_signInPageText"
+}-->
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/organization/99b24e1b-abec-4598-9d63-a2baf0a3cea1/branding/localizations/fr-FR/signInPageText
+```
++
+#### 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.organizationalBrandingLocalization"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-Type: application/json
+
+{
+ "@odata.context": "https://graph.microsoft.com/beta/$metadata#organization('99b24e1b-abec-4598-9d63-a2baf0a3cea1')/branding/localizations('fr-FR')/usernameHintText",
+ "value": "Welcome to Contoso France"
+}
+```
+
+### Example 3: Get the bannerLogo for the default locale
+
+The following example returns the **bannerLogo** object for the default locale. You may specify the **id** as `default` or `0` in the request URL. If the object is not set, the request returns an empty response.
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "ignored",
+ "name": "get_organizationalbranding_defaultlocale_bannerLogo"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/default/bannerLogo
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBranding"
+} -->
+
+```http
+HTTP/1.1 200 OK
+Content-Type: image/*
+
+<Image>
+```
+
+### Example 4: Get the bannerLogo for the fr-FR locale
+
+The following example returns the **bannerLogo** object for the `fr-FR` locale whose bannerLogo is not set.
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbranding_frlocale_bannerLogo"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/default/bannerLogo
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBranding"
+} -->
+
+```http
+HTTP/1.1 200 OK
+
+{}
+```
v1.0 Organizationalbrandinglocalization Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandinglocalization-update.md
+
+ Title: "Update organizationalBrandingLocalization"
+description: "Update the properties of an organizationalBrandingLocalization object."
+
+ms.localizationpriority: medium
++
+# Update organizationalBrandingLocalization
+Namespace: microsoft.graph
++
+Update the properties of an [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) object for a specific localization.
+
+## 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) | Organization.ReadWrite.All |
+| Delegated (personal Microsoft account) | Not supported. |
+| Application | Not supported. |
+
+## HTTP request
+
+Only Stream data types, including **backgroundLogo** and **backgroundImage**, are updated using the PUT method. To update String data types, including **signInPageText** and **usernameHintText**, use the PATCH method. You cannot update Stream types with other data types in the same request.
+
+<!-- {
+ "blockType": "ignored"
+}
+-->
+``` http
+PATCH /organization/{organizationId}/branding/localizations/{organizationalBrandingLocalizationId}
+PUT /organization/{organizationId}/branding/localizations/{organizationalBrandingLocalizationId}
+```
+
+## Request headers
+|Name|Description|
+|:|:|
+|Authorization|Bearer {token}. Required.|
+|Content-Type|application/json. Required.|
+
+## Request body
+In the request body, supply *only* the values for properties that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values.
+
+The following table specifies the properties that can be updated.
+
+| Property | Type | Description |
+|:-|:|:|
+| backgroundColor | String | Color that will appear in place of the background image in low-bandwidth connections. We recommend that you use the primary color of your banner logo or your organization color. Specify this in hexadecimal format, for example, white is `#FFFFFF`. |
+| backgroundImage | Stream | Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image will reduce bandwidth requirements and make the page load faster. |
+| bannerLogo | Stream | A banner version of your company logo that appears on the sign-in page. The allowed types are PNG or JPEG no larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo. |
+| signInPageText | String | Text that appears at the bottom of the sign-in box. You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be Unicode and not exceed 1024 characters. |
+| squareLogo | Stream | A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG no larger than 240 x 240 pixels and no more than 10 KB in size. We recommend using a transparent image with no padding around the logo.|
+| usernameHintText | String | String that shows as the hint in the username textbox on the sign-in screen. This text must be a Unicode, without links or code, and can't exceed 64 characters.|
+
+## Response
+
+If successful, this method returns a `204 No Content` response code.
+
+## Examples
+
+### Example 1: Setting **bannerLogo** for the fr-FR localization using PUT
+
+The following request updates the banner logo for the fr-FR localization.
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_organizationalbrandinglocalization"
+}-->
+
+```http
+PUT https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr-FR/bannerLogo
+Content-Type: image/jpeg
+
+<Image>
+```
++
+#### Response
+
+<!-- {
+ "blockType": "response"
+} -->
+
+```http
+HTTP/1.1 204 NO CONTENT
+```
+
+### Example 2: Update the backgroundColor and signInPageText for the fr-FR localization using PATCH
+
+The following request updates the banner logo for the `fr-FR` localization.
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_organizationalbrandinglocalization6"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr-FR
+Content-Type: application/json
+
+{
+ "backgroundColor":"#00000F",
+ "signInPageText": "Welcome to Contoso France"
+}
+```
++
+#### Response
+
+<!-- {
+ "blockType": "response"
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+++
+### Example 3: Override a default branding value with a blank string
+
+#### Request
+
+The following is an example of the request.
+<!-- {
+ "blockType": "request",
+ "name": "update_organizationalbrandinglocalization7"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr-FR
+Content-Type: application/json
+
+{
+ "signInPageText": "Welcome to Contoso France.",
+ "usernameHintText":" "
+}
+```
+
+#### Response
+
+<!-- {
+ "blockType": "response"
+} -->
+
+```http
+HTTP/1.1 204 No Content
+```
+
+Following this request, usernameHintText for the `fr-FR` localization will be empty instead of inheriting the value from the default branding object.
v1.0 Organizationalbrandingproperties Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandingproperties-create.md
- Title: "Create organizationalBrandingProperties"
-description: "Create organization branding."
-
-doc_type: "apiPageType"
--
-# Create organizationalBrandingProperties
--
-Create an [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object. This creates the default branding and optionally a localized branding at the same time. The default branding is loaded when a localized branding set isn't configured for the user's browser language.
-
-## 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) | Organization.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
-
-## HTTP request
-
-A branding is created for an organization, if one does not already exist, using PUT or PATCH.
-
-If branding is already configured, PUT will overwrite all existing values regardless of what's in the request body. PATCH will only overite the values that are included in the request body, leaving the values not included unchanged.
-
-The **id** property is ignored on PUT/PATCH to the /branding singleton. If Content-Language is not specified, the default branding is created, which corresponds to an **id** of `und`. If Content-Language is specified, branding is created for that locale.
-<!-- { "blockType": "ignored" } -->
-
-```http
-PUT /organization/{tenant id}/branding
-PATCH /organization/{tenant id}/branding
-```
-
-## 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. |
-| Content-Type | application/json. Required. |
-| Content-Language | Locale. Optional. |
-
-## Request body
-
-| Property | Type | Description |
-|:-|:|:|
-|backgroundColor|String|Color that will appear in place of the background image in low-bandwidth connections. The primary color of your banner logo or your organization color is recommended to be used here. Specify this in hexadecimal (for example, white is #FFFFFF).|
-|backgroundImage|Stream|Image that appears as the background of the sign in page. .png or .jpg not larger than 1920x1080 and smaller than 300kb. A smaller image will reduce bandwidth requirements and make page loads more performant.|
-|bannerLogo|Stream|A banner version of your company logo which appears appears on the sign-in page. .png or .jpg no larger than 36x245px. We recommend using a transparent image with no padding around the logo.|
-|signInPageText|String|Text that appears at the bottom of the sign-in box. You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be Unicode and not exceed 1024 characters.|
-|squareLogo|Stream|Square version of your company logo. This appears in Windows 10 out-of-box (OOBE) experiences and when Windows Autopilot is enabled for deployment. .png or .jpg no larger than 240x240px and no more than 10kb in size. We recommend using a transparent image with no padding around the logo.|
-|usernameHintText|String|String that shows as the hint in the username textbox on the sign in screen. This text must be Unicode, without links or code, and can't exceed 64 characters.|
-
-## Response
-
-If successful, this method returns a `201 Created` response code and the created [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object in the response body.
-
-## Examples
-
-The following example creates default branding and localization for en-US.
-
-### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_organizationalbrandingproperties_1"
-}-->
-
-```http
-PUT https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
-Content-Type: application/json
-Content-Language: en-US
-
-{
- "backgroundColor":"#FFFF33",
- "signInPageText":"Welcome",
- "usernameHintText":"hint"
-}
-```
-# [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,
- "@odata.type": "microsoft.graph.organizationalBrandingProperties"
-} -->
-
-```http
-HTTP/1.1 201 Created
-Content-Type: application/json
-Content-Language: en-US
-
-{
- "backgroundColor":"#FFFF33",
- "backgroundImage@odata.mediaContentType":"image/*",
- "backgroundImage@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/backgroundImage",
- "backgroundImage@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/backgroundImage",
- "bannerLogo@odata.mediaContentType":"image/*",
- "bannerLogo@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo",
- "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/bannerLogo",
- "id": "und",
- "signInPageText":"Welcome",
- "squareLogo@odata.mediaContentType":"image/*",
- "squareLogo@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/squareLogo",
- "squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/squareLogo",
- "usernameHintText":"hint"
-}
-```
-
-In this case, the default branding object is set. Localized branding for en-US is also set due to the Content-Language in the header, even though the en-US branding set is not returned in the response. Note that Content-Language in the request is optional, and if not present, will only set default branding.
-
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "Get organizationalBrandingProperties",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Organizationalbrandingproperties Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandingproperties-delete.md
- Title: "Delete organizationalBrandingProperties"
-description: "Delete organizationalBrandingProperties."
-
-doc_type: "apiPageType"
--
-# Delete organizationalBrandingProperties
--
-Delete an [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-| Permission type | Permissions (from least to most privileged) |
-|:|:--|
-| Delegated (work or school account) | Organization.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-DELETE /organization/{tenant id}/branding
-```
-
-## 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 `204 No Content` response code. It does not return anything in the response body.
-
-## Examples
-
-### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "delete_organizationalbrandingproperties_1"
-}-->
-
-```http
-DELETE https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
-```
-# [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
-} -->
-
-```http
-HTTP/1.1 204 No Content
-```
-
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "Delete organizationalBrandingProperties",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Organizationalbrandingproperties Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandingproperties-get.md
- Title: "Get organizationalBrandingProperties"
-description: "Retrieve the properties and relationships of an organizationalBrandingProperties object."
-
-doc_type: "apiPageType"
--
-# Get organizationalBrandingProperties
--
-Retrieve the properties and relationships of an [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-| Permission type | Permissions (from least to most privileged) |
-|:|:--|
-| Delegated (work or school account) | Organization.Read.All, User.Read, User.Read.All, User.ReadBasic.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-GET /organization/{tenant id}/branding
-```
-
-## 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. |
-
->[!NOTE]
->If you try the query in Graph Explorer, you must also include the Accept-Language request header with a valid ISO-639 locale.
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and the requested [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object in the response body.
-
-## Examples
-
-### Example 1: Get the default branding
-
->[!NOTE]
->If you try the example in Graph Explorer, you must also include the Accept-Language request header with a valid ISO-639 locale to avoid getting an error "Invalid locale id value en-US,en;q=0.9. It must be a valid ISO-639 locale."
-
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_organizationalbrandingproperties_2"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### 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.organizationalBrandingProperties"
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "backgroundColor":"#FFFF33",
- "backgroundImage@odata.mediaContentType":"image/*",
- "backgroundImage@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/backgroundImage",
- "backgroundImage@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/backgroundImage",
- "bannerLogo@odata.mediaContentType":"image/*",
- "bannerLogo@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo",
- "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo",
- "id": "und",
- "squareLogo@odata.mediaContentType":"image/*",
- "squareLogo@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/squareLogo",
- "squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/squareLogo",
- "signInPageText":"Default",
- "usernameHintText":"DefaultHint"
-}
-```
-
-Requests for /branding always return the **mediaContentType**, **mediaReadLink**, and **mediaEditLink** properties. If a locale has been applied, the **mediaEditLink** is the **mediaEditLink** for the locale (which is always non-null), and the **mediaReadLink** and **mediaContentType** are the **mediaReadLink** and **mediaContentType** of the locale if the **mediaReadLink** of the locale is non-null; otherwise, the default **mediaReadLink** and **mediaContentType**.
-
-### Example 2: Get organizational branding but no branding configured
-
-#### Request
-
-The following is an example of the request.
-<!-- {
- "blockType": "request",
- "name": "get_organizationalbrandingproperties_3"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
-```
-
-#### Response
-
-The following is an example of the response.
-
-<!-- {
- "blockType": "response"
-} -->
-
-```http
-HTTP/1.1 404 NOT FOUND
-```
-
-### Example 3: Get organizational branding for the French locale
-The Accept-Langauge header is used to apply a particular localization to the branding. Properties that are null in the specified localization are returned from the default branding. If the Accept-Language header is specified in the request, the response will include the Content-Language header, unless it is `und`.
-
-#### Request
-
-The following is an example of the request.
-<!-- {
- "blockType": "request",
- "name": "get_organizationalbrandingproperties_4"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
-Accept-Language: fr
-```
-
-#### 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.organizationalBrandingProperties"
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-Type: application/json
-Content-Language: fr
-
-{
- "backgroundColor":"#00000F",
- "backgroundImage@odata.mediaContentType":"image/*",
- "backgroundImage@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/backgroundImage",
- "backgroundImage@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/backgroundImage",
- "bannerLogo@odata.mediaContentType":"image/*",
- "bannerLogo@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo",
- "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/bannerLogo",
- "id": "und",
- "squareLogo@odata.mediaContentType":"image/*",
- "squareLogo@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/squareLogo",
- "squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/squareLogo",
- "signInPageText":"Default",
- "usernameHintText":"DefaultHint"
-}
-```
-
-### Example 4: Get bannerLogo for the French locale
-Returns **bannerLogo** for the fr locale if it exists. If the localization does not exist, returns the default **bannerLogo**.
-
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_organizationalbrandingproperties_5"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo
-Accept-Language: fr
-```
-# [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,
- "@odata.type": "microsoft.graph.organizationalBrandingProperties"
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "bannerLogo@odata.mediaContentType":"image/*",
- "bannerLogo@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo",
- "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/bannerLogo",
-}
-```
-
-### Example 5: Get bannerLogo when no bannerLogo is configured
-
-This example shows a request for a property that does not exist on the default branding or the language specified in the Accept-Language header.
-
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_organizationalbrandingproperties_6"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo
-Accept-Language: de
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### Response
-
-The following is an example of the response.
-
-<!-- {
- "blockType": "response"
-} -->
-
-```http
-HTTP/1.1 204 NO CONTENT
-```
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "Get organizationalBrandingProperties",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Organizationalbrandingproperties Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandingproperties-update.md
- Title: "Update organizationalBrandingProperties"
-description: "Update the properties of an organizationalBrandingProperties object."
-
-doc_type: "apiPageType"
--
-# Update organizationalBrandingProperties
--
-Update the properties of an [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-| Permission type | Permissions (from least to most privileged) |
-|:|:--|
-| Delegated (work or school account) | Organization.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-PATCH /organization/{tenant id}/branding
-PUT /organization/{tenant id}/branding
-```
-
-## Request headers
-
-| Name | Description|
-|:--|:--|
-| Authorization | Bearer {token}. Required. |
-| Content-Type | application/json. Required. |
-| Content-Language | Locale. Optional. |
-
-## Request body
-
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
-
-| Property | Type | Description |
-|:-|:|:|
-|backgroundColor|String|Color that will appear in place of the background image in low-bandwidth connections. The primary color of your banner logo or your organization color is recommended to be used here. Specify this in hexadecimal (for example, white is #FFFFFF).|
-|backgroundImage|Stream|Image that appears as the background of the sign in page. .png or .jpg not larger than 1920x1080 and smaller than 300kb. A smaller image will reduce bandwidth requirements and make page loads more performant.|
-|bannerLogo|Stream|A banner version of your company logo which appears appears on the sign-in page. .png or .jpg no larger than 36x245px. We recommend using a transparent image with no padding around the logo.|
-|signInPageText|String|Text that appears at the bottom of the sign-in box. You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be Unicode and not exceed 1024 characters.|
-|squareLogo|Stream|Square version of your company logo. This appears in Windows 10 out-of-box (OOBE) experiences and when Windows Autopilot is enabled for deployment. .png or .jpg no larger than 240x240px and no more than 10kb in size. We recommend using a transparent image with no padding around the logo.|
-|usernameHintText|String|String that shows as the hint in the username textbox on the sign in screen. This text must be Unicode, without links or code, and can't exceed 64 characters.|
-
-The **id** property is ignored when passed in.
-
-## Response
-
-If successful, this method returns a `204 OK` response code.
-
-## Examples
-### Example 1: Update default branding
-If the branding already exists, `PATCH` will replace only the specified properties, leaving unspecified properties unchanged.
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "update_organizationalbrandingproperties_1"
-}-->
-
-```http
-PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
-Content-Type: application/json
-
-{
- "signInPageText":"Default",
- "usernameHintText":"DefaultHint"
-}
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### Response
-The following is an example of the response.
-
-<!-- {
- "blockType": "response"
-} -->
-
-```http
-HTTP/1.1 204 OK
-```
-
-In this case, the values of the default branding are updated but no values are changed on any localization.
-
-### Example 2: Update bannerLogo for default branding
-The following request updates the banner logo for the default branding.
-#### Request
-
-The following is an example of the request.
-
-<!-- {
- "blockType": "request",
- "name": "update_organizationalbrandingproperties_2"
-}-->
-
-```http
-PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo
-Content-Type: image/jpeg
-
-<Image>
-```
-
-#### Response
-The following is an example of the response.
-
-<!-- {
- "blockType": "response"
-} -->
-
-```http
-HTTP/1.1 204 No Content
-```
-
-### Example 3: Update localized branding
-If **Content-Language** header is specified, the localization associated with **Content-Language** is first created if it doesn't already exist, and then updated using the specified values. The default branding is not changed.
-#### Request
-
-The following is an example of the request.
-<!-- {
- "blockType": "request",
- "name": "update_organizationalbrandingproperties_3"
-}-->
-
-```http
-PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
-Content-Type: application/json
-Content-Language: fr
-
-{
- "backgroundColor":"#FFFF33"
-}
-```
-
-#### Response
-The following is an example of the response.
-
-<!-- {
- "blockType": "response"
-} -->
-
-```http
-HTTP/1.1 204 No Content
-```
-
-Following this request, the `fr` localization is updated with the new value of **backgroundColor**, but no change is made to the default branding.
-
-### Example 4: Replace default branding and all localizations
-If the branding already exists, `PUT` will replace the default branding and any localizations.
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "update_organizationalbrandingproperties_4"
-}-->
-
-```http
-PUT https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
-Content-Type: application/json
-Content-Language: fr
-
-{
- "backgroundColor":"#FFFF33"
-}
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### Response
-The following is an example of the response.
-
-<!-- {
- "blockType": "response"
-} -->
-
-```http
-HTTP/1.1 204 No Content
-```
-
-Following this request, the default branding has only the **backgroundColor** specified and has exactly one localization with the **id** `fr`, also with the **backgroundColor** set.
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "Update organizationalbrandingproperties",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Organizationalbrandingpropertieslocalization Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandingpropertieslocalization-create.md
- Title: "Create localized organizationalBrandingProperties"
-description: "Create organization branding for a specific locale."
-
-doc_type: "apiPageType"
--
-# Create localized organizationalBrandingProperties
--
-Create an [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object for a specific locale.
-
-## 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) | Organization.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
-
-## HTTP request
-
-POST to branding/localizations to create a new localization. The id specified in the body is the locale for the localization. If no id is specified, then the value of the Content-Language header, if specified, is used as the id. If no id and no Content-Language header is specified, then an error is returned.
-<!-- { "blockType": "ignored" } -->
-
-```http
-POST /organization/{tenant id}/branding/localizations
-```
-
-## 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. |
-| Content-Type | application/json. Required. |
-| Content-Language | Locale. Optional. |
-
-## Request body
-
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
-
-| Property | Type | Description |
-|:-|:|:|
-|backgroundColor|String|Color that will appear in place of the background image in low-bandwidth connections. The primary color of your banner logo or your organization color is recommended to be used here. Specify this in hexadecimal (for example, white is #FFFFFF).|
-|backgroundImage|Stream|Image that appears as the background of the sign in page. .png or .jpg not larger than 1920x1080 and smaller than 300kb. A smaller image will reduce bandwidth requirements and make page loads more performant.|
-|bannerLogo|Stream|A banner version of your company logo which appears appears on the sign-in page. .png or .jpg no larger than 36x245px. We recommend using a transparent image with no padding around the logo.|
-|signInPageText|String|Text that appears at the bottom of the sign-in box. You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be Unicode and not exceed 1024 characters.|
-|squareLogo|Stream|Square version of your company logo. This appears in Windows 10 out-of-box (OOBE) experiences and when Windows Autopilot is enabled for deployment. .png or .jpg no larger than 240x240px and no more than 10kb in size. We recommend using a transparent image with no padding around the logo.|
-|usernameHintText|String|String that shows as the hint in the username textbox on the sign in screen. This text must be Unicode, without links or code, and can't exceed 64 characters.|
-|id|String|Locale to create branding for|
-
-## Response
-
-If successful, this method returns a `201 CREATED` response code and the created [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object in the response body.
-
-## Examples
-
-The following example creates a branding localization for French (fr).
-
-### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_organizationalbrandingproperties_7"
-}-->
-
-```http
-POST https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations
-Content-Type: application/json
-
-{
- "backgroundColor":"#00000F",
- "id": "fr"
-}
-```
-# [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,
- "@odata.type": "microsoft.graph.organizationalBrandingProperties"
-} -->
-
-```http
-HTTP/1.1 201 Created
-Content-Type: application/json
-
-{
- "backgroundColor":"#00000F",
- "backgroundImage@odata.mediaContentType":"image/*",
- "backgroundImage@odata.mediaReadLink": null,
- "backgroundImage@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/backgroundImage",
- "bannerLogo@odata.mediaContentType":"image/*",
- "bannerLogo@odata.mediaReadLink": null,
- "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/bannerLogo",
- "id": "fr",
- "squareLogo@odata.mediaContentType":"image/*",
- "squareLogo@odata.mediaReadLink": null,
- "squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/squareLogo"
-}
-```
-The **mediaEditLink** specifies where the localized media is written. The mediaReadLink is null because no media has been set for the localization.
-
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "Get organizationalBrandingProperties",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Organizationalbrandingpropertieslocalization Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandingpropertieslocalization-delete.md
- Title: "Delete localized organizationalBrandingProperties"
-description: "Delete organizationalBrandingProperties for a specific localization."
-
-doc_type: "apiPageType"
--
-# Delete Localized organizationalBrandingProperties
--
-Delete an [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-| Permission type | Permissions (from least to most privileged) |
-|:|:--|
-| Delegated (work or school account) | Organization.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-DELETE /organization/{tenant id}/branding/localizations/{locale}
-```
-
-## 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 `204 No Content` response code. It does not return anything in the response body.
-
-## Examples
-
-### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "delete_organizationalbrandingproperties_2"
-}-->
-
-```http
-DELETE https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr
-```
-# [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
-} -->
-
-```http
-HTTP/1.1 204 No Content
-```
-
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "Delete organizationalBrandingProperties",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Organizationalbrandingpropertieslocalization Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandingpropertieslocalization-get.md
- Title: "Get localized organizationalBrandingProperties"
-description: "Retrieve organizationalbrandingproperties object for a specific locale."
-
-doc_type: "apiPageType"
--
-# Get Localized organizationalBrandingProperties
--
-Retrieve the properties of the [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object.
-
-## Permissions
-
-One of the following permissions is required to call this API. To learn more, including how to choose permissions, see [Permissions](/graph/permissions-reference).
-
-| Permission type | Permissions (from least to most privileged) |
-|:|:--|
-| Delegated (work or school account) | Organization.Read.All, User.Read, User.Read.All, User.ReadBasic.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-GET /organization/{tenant id}/branding/localizations/{locale}
-```
-
-## 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. |
-| Content-Type | application/json. Required. |
-
-## Request body
-
-Do not supply a request body for this method.
-
-## Response
-
-If successful, this method returns a `200 OK` response code and the requested [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object in the response body. The value of "id" corresponds to the localization requested.
-
-## Examples
-### Example 1: Get the localized branding for a specific locale (fr)
-A GET request to a particular localization returns only the values for that localization. Null values will not be replaced by those from the default branding.
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_organizationalbrandingproperties_8"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### 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.organizationalBrandingProperties"
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
-"backgroundColor":"#00000F",
-"backgroundImage@odata.mediaContentType":"image/*",
-"backgroundImage@odata.mediaReadLink": null,
-"backgroundImage@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/backgroundImage",
-"bannerLogo@odata.mediaContentType":"image/*",
-"bannerLogo@odata.mediaReadLink": null,
-"bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/bannerLogo",
-"id":"fr",
-"squareLogo@odata.mediaContentType":"image/*",
-"squareLogo@odata.mediaReadLink": null,
-"squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/squareLogo",
-"signInPageText":null,
-"usernameHintText":null
-}
-```
-
-### Example 2: Get all language-specific localizations that have been configured
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_organizationalbrandingproperties_9"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### 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.organizationalBrandingProperties"
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
- "values": [
- {
- "backgroundColor":"#FFFF33",
- "backgroundImage@odata.mediaContentType":"image/*",
- "backgroundImage@odata.mediaReadLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/backgroundImage",
- "backgroundImage@odata.mediaEditLink":"https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/backgroundImage",
- "bannerLogo@odata.mediaContentType":"image/*",
- "bannerLogo@odata.mediaReadLink": null,
- "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/bannerLogo",
- "id":"en-us",
- "squareLogo@odata.mediaContentType":"image/*",
- "squareLogo@odata.mediaReadLink": null,
- "squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/squareLogo",
- "signInPageText":"Welcome",
- "usernameHintText":"hint"
- },
- {
- "backgroundColor":"#00000F",
- "backgroundImage@odata.mediaContentType":"image/*",
- "backgroundImage@odata.mediaReadLink": null,
- "backgroundImage@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/bannerLogo",
- "bannerLogo@odata.mediaContentType":"image/*",
- "bannerLogo@odata.mediaReadLink": null,
- "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/bannerLogo",
- "id":"fr",
- "squareLogo@odata.mediaContentType":"image/*",
- "squareLogo@odata.mediaReadLink": null,
- "squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/squareLogo",
- "signInPageText":null,
- "usernameHintText":null
- }
- ]
-}
-```
-
-### Example 3: Get the value of signInPageText for a specific locale
-Requesting a property of a localization returns that value, or 204 if the value is null.
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "get_organizationalbrandingproperties_10"
-}-->
-
-```msgraph-interactive
-GET https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/signInPageText
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### 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.organizationalBrandingProperties"
-} -->
-
-```http
-HTTP/1.1 200 OK
-Content-Type: application/json
-
-{
-"value":"Welcome"
-}
-```
-
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "Get organizationalBrandingProperties",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Organizationalbrandingpropertieslocalization Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/organizationalbrandingpropertieslocalization-update.md
- Title: "Update localized organizationalbrandingproperties"
-description: "Update the properties of the organizationalbrandingproperties object for a specific localization."
-
-doc_type: "apiPageType"
--
-# Update Localized organizationalbrandingproperties
--
-Update the properties of the [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object for a specific localization.
-
-## 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) | Organization.ReadWrite.All |
-| Delegated (personal Microsoft account) | Not supported. |
-| Application | Not supported. |
-
-## HTTP request
-
-<!-- { "blockType": "ignored" } -->
-
-```http
-PATCH /organization/{tenant id}/branding/localizations/{locale}
-PUT /organization/{tenant id}/branding/localizations/{locale}
-```
-
-## Request headers
-
-| Name | Description|
-|:--|:--|
-| Authorization | Bearer {token}. Required. |
-| Content-Type | application/json. Required. |
-| Content-Language | Locale. Optional. |
-
-## Request body
-
-In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance, don't include existing values that haven't changed.
-
-| Property | Type | Description |
-|:-|:|:|
-|backgroundColor|String|Color that will appear in place of the background image in low-bandwidth connections. The primary color of your banner logo or your organization color is recommended to be used here. Specify this in hexadecimal (for example, white is #FFFFFF).|
-|backgroundImage|Stream|Image that appears as the background of the sign in page. .png or .jpg not larger than 1920x1080 and smaller than 300kb. A smaller image will reduce bandwidth requirements and make page loads more performant.|
-|bannerLogo|Stream|A banner version of your company logo which appears appears on the sign-in page. .png or .jpg no larger than 36x245px. We recommend using a transparent image with no padding around the logo.|
-|signInPageText|String|Text that appears at the bottom of the sign-in box. You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be Unicode and not exceed 1024 characters.|
-|squareLogo|Stream|Square version of your company logo. This appears in Windows 10 out-of-box (OOBE) experiences and when Windows Autopilot is enabled for deployment. .png or .jpg no larger than 240x240px and no more than 10kb in size. We recommend using a transparent image with no padding around the logo.|
-|usernameHintText|String|String that shows as the hint in the username textbox on the sign in screen. This text must be Unicode, without links or code, and can't exceed 64 characters.|
-|id|String|Locale to update branding for|
--
-## Response
-
-If successful, this method returns a `204 OK` response code.
-
-## Examples
-
-### Example 1: Setting **bannerLogo** for the fr localization using PUT
-
-The following request updates the banner logo for the fr localization. Using PUT, if the fr localization does not exist, "404 not found" is returned. If the payload contains an id property or Content-Language header, and they don't match id in URL, a Bad Request is returned.
-
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "update_organizationalbrandingproperties_5"
-}-->
-
-```http
-PUT https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/bannerLogo
-Content-Type: image/jpeg
-
-<Image>
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### Response
-
-The following is an example of the response.
-
-<!-- {
- "blockType": "response"
-} -->
-
-```http
-HTTP/1.1 204 NO CONTENT
-```
-
-### Example 2: Update **bannerLogo** for the fr localization using PATCH
-
-The following request updates the banner logo for the fr localization. Using PATCH, if the specified localization does not already exist, it is created and the property is written to it.
-
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "update_organizationalbrandingproperties_6"
-}-->
-
-```http
-PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr
-Content-Type: application/json
-
-{
- "backgroundColor":"#00000F",
- "signInPageText": "fr"
-}
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### Response
-The following is an example of the response.
-
-<!-- {
- "blockType": "response"
-} -->
-
-```http
-HTTP/1.1 204 No Content
-```
---
-### Example 3: Override default branding value with a blank string
-
-If the value of a property in a localization is null, the value will be inherited from the default branding. To prevent this from happening, set an empty string or string containing only whitespace in the localized branding.
-
-#### Request
-
-The following is an example of the request.
-<!-- {
- "blockType": "request",
- "name": "update_organizationalbrandingproperties_7"
-}-->
-
-```http
-PATCH https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr
-Content-Type: application/json
-
-{
- "signInPageText": "French sign-in text.",
- "usernameHintText":" "
-}
-```
-
-#### Response
-
-The following is an example of the response.
-
-<!-- {
- "blockType": "response"
-} -->
-
-```http
-HTTP/1.1 204 No Content
-```
-
-Following this request, usernameHintText for the fr localization will be empty instead of inheriting the value from default branding.
-
-### Example 4: Replace French localization with PUT
-
-To make an update on localization using PUT, we should add all properties in body along with the property that needs to be updated as PUT replaces existing object with the new one. The other properties which are not in the payload body of PUT will be set to NULL. Here in example below, only backgroundColor property is retained and signInPageText is updated while others are set to null.
-If the specified localization does not already exist, PUT to the URL specifying that localization creates it.
-If the payload contains an id property or a Content-Language header, and they don't match id in URL, we throw Bad request.
-
-#### Request
-
-The following is an example of the request.
-
-# [HTTP](#tab/http)
-<!-- {
- "blockType": "request",
- "name": "update_organizationalbrandingproperties_8"
-}-->
-
-```http
-PUT https://graph.microsoft.com/beta/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr
-Content-Type: application/json
-
-{
- "backgroundColor":"#00000F",
- "signInPageText": "fr"
-}
-```
-# [C#](#tab/csharp)
-
-# [JavaScript](#tab/javascript)
-
-# [Objective-C](#tab/objc)
-
-# [Java](#tab/java)
----
-#### Response
-The following is an example of the response.
-
-<!-- {
- "blockType": "response"
-} -->
-
-```http
-HTTP/1.1 204 No Content
-```
-
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "Update organizationalbrandingproperties",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Accessreviewsv2 Root https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/accessreviewsv2-root.md
Namespace: microsoft.graph
[!INCLUDE [accessreviews-disclaimer-v2](../../includes/accessreviews-disclaimer-v2.md)]
+Use [Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-access-reviews-overview) to configure one-time or recurring access reviews for attestation of users' rights to access Azure AD resources. These Azure AD resources include groups, service principals, access packages, and privileged roles.
-You can use [Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-access-reviews-overview) to configure one-time or recurring access reviews for attestation of user's access rights.
+Typical customer scenarios for access reviews include:
-Typical customer scenarios for access reviews of group memberships and application and Azure AD role access are:
--- Customers can review and certify guest user access to applications, Azure AD roles, and memberships of groups. Reviewers can use the insights that are provided to efficiently decide whether guests should have continued access.--- Customers can review and certify employee access to applications, Azure AD roles, and group memberships with access reviews.
+- Customers can review and certify guest user access to groups through group memberships. Reviewers can use the insights that are provided to efficiently decide whether guests should have continued access.
+- Customers can review and certify employee access to Azure AD resources.
+- Customers can review and audit assignments to Azure AD privileged roles. This supports organizations in the management of privileged access.
Note that the access reviews feature, including the API, is included in Azure AD Premium P2. The tenant where an access review is being created must have a valid purchased or trial Azure AD Premium P2 or EMS E5 subscription.
The following table lists the methods that you can use to interact with access r
## Role and application permission authorization checks
-The following directory roles are required for a calling user to manage access reviews.
+The following [Azure AD roles](/azure/active-directory/roles/permissions-reference) are required for a calling user to manage access reviews.
| Operation | Application permissions | Required directory role of the calling user | |:|:|:--|
In addition, a user who is an assigned reviewer of an access review can manage t
## See also
+- [Tutorials](/graph/accessreviews-overview) to learn how to use the access reviews API to review access to Azure AD resources
- [How an administrator can manage user access with Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-manage-user-access-with-access-reviews) - [How an administrator can manage guest access with Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-manage-guest-access-with-access-reviews)
v1.0 Device https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/device.md
This resource lets you add your own data to custom properties using [extensions]
| Property | Type |Description| |:|:--|:-|
-|accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. Default is `true`. Supports `$filter` (`eq`, `ne`, `NOT`, `in`).|
+|accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. Default is `true`. <br/><br/> Supports `$filter` (`eq`, `ne`, `NOT`, `in`). Only callers in Global Administrator and Cloud Device Administrator roles can set this property.|
|alternativeSecurityIds|[alternativeSecurityId](alternativeSecurityId.md) collection| For internal use only. Not nullable. Supports `$filter` (`eq`, `NOT`, `ge`, `le`). | |approximateLastSignInDateTime|DateTimeOffset| 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. Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`) and `$orderBy`. | |complianceExpirationDateTime|DateTimeOffset| The timestamp when the device is no longer deemed compliant. 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. |
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]
|[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](../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 an organizationalBrandingProperties object collection. |
-|[Get branding](../api/organizationalbrandingproperties-get.md) | [organizationalBrandingProperties](organizationalbrandingproperties.md) collection | Get a collection of organizationalBrandingProperties objects. |
+|**Organization licenses**| | |
|[activateService](../api/organization-activateservice.md) | None | Activate a service for an organization. |
+|**Organizational branding**| | |
+|[Create organizationalBrandingLocalization](../api/organizationalbranding-post-localizations.md) | [organizationalBrandingLocalization](organizationalbrandinglocalization.md) | Create a new localization (language-specific) branding and a default branding object, if it doesn't exist. |
+|[Get organizationalBranding](../api/organizationalbranding-get.md) | [organizationalBranding](organizationalbranding.md) | Get the default organizational branding object. |
+|[Update organizationalBranding](../api/organizationalbranding-update.md) | [organizationalBranding](organizationalbranding.md) | Update the default organizational branding object. |
+|[Delete organizationalBranding](../api/organizationalbranding-update.md) | [organizationalBranding](organizationalbranding.md) | Delete the default organizational branding object. |
+|[List organizationalBrandingLocalization](../api/organizationalbrandinglocalization-get.md) | [organizationalBrandingLocalization](organizationalbrandinglocalization.md) collection | Retrieve all localization branding objects in the tenant. |
+|[Get organizationalBrandingLocalization](../api/organizationalbrandinglocalization-get.md) | [organizationalBrandingLocalization](organizationalbrandinglocalization.md) | Read the properties of a localization branding object. |
+|[Update organizationalBranding](../api/organizationalbranding-update.md) | [organizationalBranding](organizationalbranding.md) | Update a localization branding object. |
+|[Delete organizationalBranding](../api/organizationalbranding-update.md) | [organizationalBranding](organizationalbranding.md) | Delete a localization branding object. |
## Properties
This resource lets you add your own data to custom properties using [extensions]
| Relationship | Type |Description| |:|:--|:-|
-|certificateBasedAuthConfiguration|[certificateBasedAuthConfiguration](certificatebasedauthconfiguration.md) collection| Navigation property to manage certificate-based authentication configuration. Only a single instance of certificateBasedAuthConfiguration can be created in the collection. |
+|certificateBasedAuthConfiguration|[certificateBasedAuthConfiguration](certificatebasedauthconfiguration.md) collection| Navigation property to manage certificate-based authentication configuration. Only a single instance of certificateBasedAuthConfiguration can be created in the collection. |
|extensions|[extension](extension.md) collection|The collection of open extensions defined for the organization resource. Nullable.|
-|organizationalBranding|[organizationalBrandingProperties](organizationalbrandingproperties.md) collection| Branding for the organization. Nullable.|
+|organizationalBranding|[organizationalBranding](organizationalbranding.md) collection| Resource to manage the default branding for the organization. Nullable.|
|settings|[organizationSettings](organizationsettings.md) | Retrieve the properties and relationships of organizationSettings object. Nullable.| ## JSON representation
Here is a JSON representation of the resource
```json { "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}],
- "businessPhones": ["string"],
- "city": "string",
- "country": "string",
- "countryLetterCode": "string",
+ "businessPhones": ["String"],
+ "city": "String",
+ "country": "String",
+ "countryLetterCode": "String",
"createdDateTime": "String (timestamp)", "deletedDateTime": "String (timestamp)", "directorySizeQuota": {"@odata.type": "microsoft.graph.directorySizeQuota"},
- "displayName": "string",
- "id": "string (identifier)",
- "isMultipleDataLocationsForServicesEnabled": "boolean",
- "marketingNotificationEmails": ["string"],
- "objectType": "string",
+ "displayName": "String",
+ "id": "String (identifier)",
+ "isMultipleDataLocationsForServicesEnabled": "Boolean",
+ "marketingNotificationEmails": ["String"],
+ "objectType": "String",
"onPremisesLastSyncDateTime": "String (timestamp)", "onPremisesSyncEnabled": true,
- "postalCode": "string",
- "preferredLanguage": "string",
+ "postalCode": "String",
+ "preferredLanguage": "String",
"privacyProfile": {"@odata.type": "microsoft.graph.privacyProfile"}, "provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
- "securityComplianceNotificationMails": ["string"],
- "securityComplianceNotificationPhones": ["string"],
- "state": "string",
- "street": "string",
- "technicalNotificationMails": ["string"],
+ "securityComplianceNotificationMails": ["String"],
+ "securityComplianceNotificationPhones": ["String"],
+ "state": "String",
+ "street": "String",
+ "technicalNotificationMails": ["String"],
"verifiedDomains": [{"@odata.type": "microsoft.graph.verifiedDomain"}], "companyLastDirSyncTime": "2019-02-07T20:33:52.942Z", "dirSyncEnabled": true
v1.0 Organizationalbranding https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/organizationalbranding.md
+
+ Title: "organizationalBranding resource type"
+description: "Contains details of the organization's branding."
+
+ms.localizationpriority: medium
++
+# organizationalBranding resource type
+
+Namespace: microsoft.graph
++
+Contains details about the organization's default branding. Inherits from [organizationalBrandingProperties](organizationalbrandingproperties.md).
+
+Organizations can customize their Azure Active Directory (Azure AD) sign-in pages which appear when users sign in to their organization's tenant-specific apps, or when Azure AD identifies the user's tenant from their username. A developer can also read the company's branding information and customize their app experience to tailor it specifically for the signed-in user using their company's branding.
+
+You can't change your original configuration's language. However, companies can add different branding based on locale. For language-specific branding, see the [organizationalBrandingLocalization](organizationalbrandingproperties.md) object.
+
+>[!NOTE]
+>Adding custom branding requires you to have either Azure Active Directory (Azure AD) Premium 1, Premium 2, or Office 365 (for Office 365 apps) licenses. For more information about licensing and editions, see [Sign up for Azure AD Premium](/azure/active-directory/fundamentals/active-directory-get-started-premium).
+>
+>Azure AD Premium editions are available for customers in China using the worldwide instance of Azure Active Directory. Azure AD Premium editions aren't currently supported in the Azure service operated by 21Vianet in China. For more information, talk to us using the [Azure Active Directory Forum](https://feedback.azure.com/forums/169401-azure-active-directory/).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+| [Get organizationalBranding](../api/organizationalbranding-get.md) | [organizationalBranding](../resources/organizationalbranding.md) | Read the properties and relationships of an [organizationalBranding](../resources/organizationalbranding.md) object. |
+| [Update organizationalBranding](../api/organizationalbranding-update.md) | None | Update the properties of an [organizationalBranding](../resources/organizationalbranding.md) object. |
+| [Delete organizationalBranding](../api/organizationalbranding-delete.md) | None | Delete an [organizationalBranding](../resources/organizationalbranding.md) object. |
+
+## Properties
+| Property | Type | Description |
+|:-|:|:|
+| backgroundColor | String | Color that will appear in place of the background image in low-bandwidth connections. We recommend that you use the primary color of your banner logo or your organization color. Specify this in hexadecimal format, for example, white is `#FFFFFF`. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| backgroundImage | Stream | Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image will reduce bandwidth requirements and make the page load faster. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). Returned only on `$select`. |
+| backgroundImageRelativeUrl | String | A relative URL for the **backgroundImage** property that is combined with a CDN base URL from the **cdnList** to provide the version served by a CDN. Read-only. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| bannerLogo | Stream | A banner version of your company logo that appears on the sign-in page. The allowed types are PNG or JPEG no larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). Returned only on `$select`. |
+| bannerLogoRelativeUrl | String | A relative url for the **bannerLogo** property that is combined with a CDN base URL from the **cdnList** to provide the read-only version served by a CDN. Read-only. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| cdnList | String collection | A list of base URLs for all available CDN providers that are serving the assets of the current resource. Several CDN providers are used at the same time for high availability of read requests. Read-only. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| id | String | An identifier that represents the locale specified in the ISO 639-1 standard, for example English is `en-us` or `en`. The **id** for the default /branding is always the String types `0` or `default`. Read-only. <br/><br/>**NOTE:** Multiple branding for a single locale are currently not supported. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| signInPageText | String | Text that appears at the bottom of the sign-in box. You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be Unicode and not exceed 1024 characters. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| squareLogo | Stream | A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG no larger than 240 x 240 pixels and no more than 10 KB in size. We recommend using a transparent image with no padding around the logo. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). Returned only on `$select`.|
+| squareLogoRelativeUrl | String | A relative url for the **squareLogo** property that is combined with a CDN base URL from the **cdnList** to provide the version served by a CDN. Read-only. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| usernameHintText | String | String that shows as the hint in the username textbox on the sign-in screen. This text must be a Unicode, without links or code, and can't exceed 64 characters. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+
+## Relationships
+|Relationship|Type|Description|
+|:|:|:|
+| localizations | [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) collection | Add different branding based on a locale. |
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.organizationalBranding",
+ "baseType": "microsoft.graph.organizationalBrandingProperties",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.organizationalBranding",
+ "id": "String (identifier)",
+ "backgroundColor": "String",
+ "backgroundImage": "Stream",
+ "backgroundImageRelativeUrl": "String",
+ "bannerLogo": "Stream",
+ "bannerLogoRelativeUrl": "String",
+ "cdnList": [
+ "String"
+ ],
+ "signInPageText": "String",
+ "squareLogo": "Stream",
+ "squareLogoRelativeUrl": "String",
+ "usernameHintText": "String"
+}
+```
v1.0 Organizationalbrandinglocalization https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/organizationalbrandinglocalization.md
+
+ Title: "organizationalBrandingLocalization resource type"
+description: "Contains details of the organization's branding localizations."
+
+ms.localizationpriority: medium
++
+# organizationalBrandingLocalization resource type
+
+Namespace: microsoft.graph
++
+Resource that supports managing language-specific branding. While you can't change your original configuration's language, this resource allows you to create a new configuration for a different language.
+
+Inherits from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md).
+
+## Methods
+|Method|Return type|Description|
+|:|:|:|
+|[List organizationalBrandingLocalizations](../api/organizationalbranding-list-localizations.md)|[organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) collection|Get a list of the [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) objects and their properties.|
+|[Create organizationalBrandingLocalization](../api/organizationalbranding-post-localizations.md)|[organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md)|Create a new [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) object.|
+|[Get organizationalBrandingLocalization](../api/organizationalbrandinglocalization-get.md)|[organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md)|Read the properties and relationships of an [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) object.|
+|[Update organizationalBrandingLocalization](../api/organizationalbrandinglocalization-update.md)| None |Update the properties of an [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) object.|
+|[Delete organizationalBrandingLocalization](../api/organizationalbrandinglocalization-delete.md)|None|Deletes an [organizationalBrandingLocalization](../resources/organizationalbrandinglocalization.md) object.|
+
+## Properties
+| Property | Type | Description |
+|:-|:|:|
+| backgroundColor | String | Color that will appear in place of the background image in low-bandwidth connections. We recommend that you use the primary color of your banner logo or your organization color. Specify this in hexadecimal format, for example, white is `#FFFFFF`. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| backgroundImage | Stream | Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image will reduce bandwidth requirements and make the page load faster. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| backgroundImageRelativeUrl | String | A relative URL for the **backgroundImage** property that is combined with a CDN base URL from the **cdnList** to provide the version served by a CDN. Read-only. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| bannerLogo | Stream | A banner version of your company logo that appears on the sign-in page. The allowed types are PNG or JPEG no larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| bannerLogoRelativeUrl | String | A relative url for the **bannerLogo** property that is combined with a CDN base URL from the **cdnList** to provide the read-only version served by a CDN. Read-only. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| cdnList | String collection | A list of base URLs for all available CDN providers that are serving the assets of the current resource. Several CDN providers are used at the same time for high availability of read requests. Read-only. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| id | String | An identifier that represents the locale specified in the ISO 639-1 standard, for example English is `en-us` or `en`. The **id** for the default /branding is always the String types `0` or `default`. Read-only. <br/><br/>**NOTE:** Multiple branding for a single locale are currently not supported. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| signInPageText | String | Text that appears at the bottom of the sign-in box. You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be Unicode and not exceed 1024 characters. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| squareLogo | Stream | A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG no larger than 240 x 240 pixels and no more than 10 KB in size. We recommend using a transparent image with no padding around the logo. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md).|
+| squareLogoRelativeUrl | String | A relative url for the **squareLogo** property that is combined with a CDN base URL from the **cdnList** to provide the version served by a CDN. Read-only. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+| usernameHintText | String | String that shows as the hint in the username textbox on the sign-in screen. This text must be a Unicode, without links or code, and can't exceed 64 characters. Inherited from [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md). |
+
+## Relationships
+None.
+
+## JSON representation
+The following is a JSON representation of the resource.
+<!-- {
+ "blockType": "resource",
+ "keyProperty": "id",
+ "@odata.type": "microsoft.graph.organizationalBrandingLocalization",
+ "baseType": "microsoft.graph.organizationalBrandingProperties",
+ "openType": false
+}
+-->
+``` json
+{
+ "@odata.type": "#microsoft.graph.organizationalBrandingLocalization",
+ "id": "String (identifier)",
+ "backgroundColor": "String",
+ "backgroundImage": "Stream",
+ "backgroundImageRelativeUrl": "String",
+ "bannerLogo": "Stream",
+ "bannerLogoRelativeUrl": "String",
+ "cdnList": [
+ "String"
+ ],
+ "signInPageText": "String",
+ "squareLogo": "Stream",
+ "squareLogoRelativeUrl": "String",
+ "usernameHintText": "String"
+}
+```
v1.0 Organizationalbrandingproperties https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/organizationalbrandingproperties.md
Title: "organizationalBrandingProperties resource type" description: "Contains details of the organization's branding."
+ms.localizationpriority: medium
ms.prod: "identity-and-sign-in"
-doc_type: "resourcePageType"
# organizationalBrandingProperties resource type
+Namespace: microsoft.graph
->[!NOTE]
->Adding custom branding requires you to use Azure Active Directory Premium 1, Premium 2, or Basic editions, or to have a Microsoft 365 license. For more information about licensing and editions, see [Sign up for Azure AD Premium](/azure/active-directory/fundamentals/active-directory-get-started-premium).<br><br>Azure AD Premium and Basic editions are available for customers in China using the worldwide instance of Azure Active Directory. Azure AD Premium and Basic editions aren't currently supported in the Azure service operated by 21Vianet in China. For more information, talk to us using the [Azure Active Directory Forum](https://feedback.azure.com/forums/169401-azure-active-directory/).
-Contains details about the organization's branding.
+An abstract type that exposes properties for configuring an organization's branding.
-Organizations can customize their Azure AD sign-in pages which appear when users sign in to their organization's tenant-specific apps, or when Azure AD identifies the user's tenant from their username. A developer can also read the company's branding information and customize their app experience to tailor it specifically for the signed-in user using their company's branding.
+Organizations can customize their Azure Active Directory (Azure AD) sign-in pages which appear when users sign in to their organization's tenant-specific apps, or when Azure AD identifies the user's tenant from their username. A developer can also read the company's branding information and customize their app experience to tailor it specifically for the signed-in user using their company's branding.
-Companies can add different branding based on locale. Locale serves as a key in all requests.
+You can't change your original configuration's language. However, companies can add different branding based on locale. For language-specific branding, see the [organizationalBrandingLocalization](organizationalbrandinglocalization.md) object.
->**Note:** Branding is exposed as a property under organization with a collection of locale-specific localizations. **organizationalBrandingProperties** is an abstract class which defines properties for **organizationalBranding**.
+>[!NOTE]
+>Adding custom branding requires you to have either Azure Active Directory (Azure AD) Premium 1, Premium 2, or Office 365 (for Office 365 apps) licenses. For more information about licensing and editions, see [Sign up for Azure AD Premium](/azure/active-directory/fundamentals/active-directory-get-started-premium).
+>
+>Azure AD Premium editions are available for customers in China using the worldwide instance of Azure Active Directory. Azure AD Premium editions aren't currently supported in the Azure service operated by 21Vianet in China. For more information, talk to us using the [Azure Active Directory Forum](https://feedback.azure.com/forums/169401-azure-active-directory/).
## Methods-
-| Method | Return Type | Description |
-|:-|:|:|
-| [Create](../api/organizationalbrandingproperties-create.md) | [organizationalBrandingProperties](organizationalbrandingproperties.md) | Create organizational branding with organizationalBrandingProperties object. |
-| [Get](../api/organizationalbrandingproperties-get.md) | [organizationalBrandingProperties](organizationalbrandingproperties.md) | Read properties and relationships of organizationalBrandingProperties object. |
-| [Update](../api/organizationalbrandingproperties-update.md) | [organizationalBrandingProperties](organizationalbrandingproperties.md) | Update organizationalBrandingProperties object. |
-| [Delete](../api/organizationalbrandingproperties-delete.md) | None | Delete organizationalBrandingProperties object. |
+None.
## Properties- | Property | Type | Description | |:-|:|:|
-|backgroundColor|String| Color that will appear in place of the background image in low-bandwidth connections. The primary color of your banner logo or your organization color is recommended to be used here. Specify this in hexadecimal (for example, white is #FFFFFF). |
-|backgroundImage|Stream| Image that appears as the background of the sign in page. .png or .jpg not larger than 1920x1080 and smaller than 300kb. A smaller image will reduce bandwidth requirements and make page loads more performant. |
-|bannerLogo|Stream| A banner version of your company logo which appears appears on the sign-in page. .png or .jpg no larger than 36x245px. We recommend using a transparent image with no padding around the logo. |
-|id|String| This is an id, inherited from microsoft.graph.entity, is the locale specifying the ISO 639 standard for language, for example English is "en-us" or "en". Going forward if we expose functionality to have multiple brandings for one locale, this can be changed. Note that id for Default /branding is always 'und' until we have keyless singletons. Read-only. |
-|signInPageText|String| Text that appears at the bottom of the sign-in box. You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be Unicode and not exceed 1024 characters. |
-|squareLogo|Stream| Square version of your company logo. This appears in Windows 10 out-of-box (OOBE) experiences and when Windows Autopilot is enabled for deployment. .png or .jpg no larger than 240x240px and no more than 10kb in size. We recommend using a transparent image with no padding around the logo. |
-|usernameHintText|String| String that shows as the hint in the username textbox on the sign in screen. This text must be Unicode, without links or code, and can't exceed 64 characters. |
+| backgroundColor | String | Color that will appear in place of the background image in low-bandwidth connections. We recommend that you use the primary color of your banner logo or your organization color. Specify this in hexadecimal format, for example, white is `#FFFFFF`. |
+| backgroundImage | Stream | Image that appears as the background of the sign-in page. The allowed types are PNG or JPEG not smaller than 300 KB and not larger than 1920 × 1080 pixels. A smaller image will reduce bandwidth requirements and make the page load faster. |
+| backgroundImageRelativeUrl | String | A relative URL for the **backgroundImage** property that is combined with a CDN base URL from the **cdnList** to provide the version served by a CDN. Read-only. |
+| bannerLogo | Stream | A banner version of your company logo that appears on the sign-in page. The allowed types are PNG or JPEG no larger than 36 × 245 pixels. We recommend using a transparent image with no padding around the logo. |
+| bannerLogoRelativeUrl | String | A relative url for the **bannerLogo** property that is combined with a CDN base URL from the **cdnList** to provide the read-only version served by a CDN. Read-only. |
+| cdnList | String collection | A list of base URLs for all available CDN providers that are serving the assets of the current resource. Several CDN providers are used at the same time for high availability of read requests. Read-only. |
+| id | String | An identifier that represents the locale specified in the ISO 639-1 standard, for example English is `en-us` or `en`. The **id** for the default /branding is always the String types `0` or `default`. Read-only. <br/><br/>**NOTE:** Multiple branding for a single locale are currently not supported. |
+| signInPageText | String | Text that appears at the bottom of the sign-in box. You can use this to communicate additional information, such as the phone number to your help desk or a legal statement. This text must be Unicode and not exceed 1024 characters. |
+| squareLogo | Stream | A square version of your company logo that appears in Windows 10 out-of-box experiences (OOBE) and when Windows Autopilot is enabled for deployment. Allowed types are PNG or JPEG no larger than 240 x 240 pixels and no more than 10 KB in size. We recommend using a transparent image with no padding around the logo. |
+| squareLogoRelativeUrl | String | A relative url for the **squareLogo** property that is combined with a CDN base URL from the **cdnList** to provide the version served by a CDN. Read-only. |
+| usernameHintText | String | String that shows as the hint in the username textbox on the sign-in screen. This text must be a Unicode, without links or code, and can't exceed 64 characters. |
## Relationships-
-None
+None.
## JSON representation- The following is a JSON representation of the resource.- <!-- { "blockType": "resource",
- "optionalProperties": [
-
- ],
+ "keyProperty": "id",
"@odata.type": "microsoft.graph.organizationalBrandingProperties",
- "keyProperty": "id"
-}-->
-
-```json
+ "openType": false
+}
+-->
+``` json
{
+ "@odata.type": "#microsoft.graph.organizationalBrandingProperties",
+ "id": "String (identifier)",
"backgroundColor": "String", "backgroundImage": "Stream",
+ "backgroundImageRelativeUrl": "String",
"bannerLogo": "Stream",
- "id": "String (identifier)",
+ "bannerLogoRelativeUrl": "String",
+ "cdnList": [
+ "String"
+ ],
"signInPageText": "String", "squareLogo": "Stream",
+ "squareLogoRelativeUrl": "String",
"usernameHintText": "String" } ```
-<!-- uuid: 16cd6b66-4b1a-43a1-adaf-3a886856ed98
-2019-02-04 14:57:30 UTC -->
-<!-- {
- "type": "#page.annotation",
- "description": "organizationalBrandingProperties resource",
- "keywords": "",
- "section": "documentation",
- "tocPath": ""
-}-->
v1.0 Unifiedrolemanagementpolicyruletarget https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/unifiedrolemanagementpolicyruletarget.md
A unifiedRoleManagementPolicyRuleTarget specifies the target associated with the
|Relationship|Type|Description| |:|:|:| |targetObjects|[directoryObject](../resources/directoryobject.md) collection|The collection of users, groups and servicePrincipals which are in scope of the policy. If not specified, all objects are in scope of the policy.|>+ ## JSON representation The following is a JSON representation of the resource. <!-- {
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/user.md
This resource supports:
| surname | String | The user's surname (family name or last name). Maximum length is 64 characters. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`). | | usageLocation | String | A two letter country code (ISO standard 3166). Required for users that will be assigned licenses due to legal requirement to check for availability of services in countries. Examples include: `US`, `JP`, and `GB`. Not nullable. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`).| | userPrincipalName | String | The user principal name (UPN) of the user. The UPN is an Internet-style login name for the user based on the Internet standard RFC 822. By convention, this should map to the user's email name. The general format is alias@domain, where domain must be present in the tenant's collection of verified domains. This property is required when a user is created. The verified domains for the tenant can be accessed from the **verifiedDomains** property of [organization](organization.md).<br>NOTE: This property cannot contain accent characters. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`, `endsWith`) and `$orderBy`.
-| userType | String | A string value that can be used to classify user types in your directory, such as `Member` and `Guest`. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `in`,). |
+| userType | String | A String value that can be used to classify user types in your directory, such as `Member` and `Guest`. <br><br>Supports `$filter` (`eq`, `ne`, `NOT`, `in`,). |
### Legal age group property definitions
This section explains how the three age group properties (**legalAgeGroupClassif
For example: Cameron is administrator of a directory for an elementary school in Holyport in the United Kingdom. At the beginning of the school year he uses the admissions paperwork to obtain consent from the minor's parents based on the age-related regulations of the United Kingdom. The consent obtained from the parent allows the minor's account to be used by Holyport school and Microsoft apps. Cameron then creates all the accounts and sets ageGroup to "minor" and consentProvidedForMinor to "granted". Applications used by his students are then able to suppress features that are not suitable for minors. <!-- Note that the following 3 sub-sections are only documented like enums for a consistent user experience. For some reason they are not defined as enums in the CSDL.
-Hence the type of the corresponding 3 properties remain as string type in the Properties table.
+Hence the type of the corresponding 3 properties remain as String type in the Properties table.
--> #### legalAgeGroupClassification values
Here is a JSON representation of the resource
```json {
- "aboutMe": "string",
+ "aboutMe": "String",
"accountEnabled": true,
- "ageGroup": "string",
+ "ageGroup": "String",
"assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}], "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}], "birthday": "String (timestamp)",
- "businessPhones": ["string"],
- "city": "string",
- "companyName": "string",
- "consentProvidedForMinor": "string",
- "country": "string",
+ "businessPhones": ["String"],
+ "city": "String",
+ "companyName": "String",
+ "consentProvidedForMinor": "String",
+ "country": "String",
"createdDateTime": "2019-02-07T21:53:13.067Z",
- "creationType": "string",
+ "creationType": "String",
"deletedDateTime": "String (timestamp)",
- "department": "string",
- "displayName": "string",
+ "department": "String",
+ "displayName": "String",
"employeeHireDate": "2020-01-01T00:00:00Z",
- "employeeId": "string",
+ "employeeId": "String",
"employeeOrgData": {"@odata.type": "microsoft.graph.employeeOrgData"},
- "employeeType": "string",
+ "employeeType": "String",
"externalUserState": "PendingAcceptance", "externalUserStateChangeDateTime": "2018-11-12T01:13:13Z",
- "faxNumber": "string",
- "givenName": "string",
+ "faxNumber": "String",
+ "givenName": "String",
"hireDate": "String (timestamp)",
- "id": "string (identifier)",
+ "id": "String (identifier)",
"identities": [{"@odata.type": "microsoft.graph.objectIdentity"}],
- "interests": ["string"],
+ "interests": ["String"],
"isResourceAccount": false,
- "jobTitle": "string",
- "legalAgeGroupClassification": "string",
+ "jobTitle": "String",
+ "legalAgeGroupClassification": "String",
"licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}],
- "mail": "string",
+ "mail": "String",
"mailboxSettings": {"@odata.type": "microsoft.graph.mailboxSettings"},
- "mailNickname": "string",
- "mobilePhone": "string",
- "mySite": "string",
- "officeLocation": "string",
- "onPremisesDistinguishedName": "string",
- "onPremisesDomainName": "string",
+ "mailNickname": "String",
+ "mobilePhone": "String",
+ "mySite": "String",
+ "officeLocation": "String",
+ "onPremisesDistinguishedName": "String",
+ "onPremisesDomainName": "String",
"onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
- "onPremisesImmutableId": "string",
+ "onPremisesImmutableId": "String",
"onPremisesLastSyncDateTime": "String (timestamp)", "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
- "onPremisesSamAccountName": "string",
- "onPremisesSecurityIdentifier": "string",
+ "onPremisesSamAccountName": "String",
+ "onPremisesSecurityIdentifier": "String",
"onPremisesSyncEnabled": true,
- "onPremisesUserPrincipalName": "string",
- "otherMails": ["string"],
- "passwordPolicies": "string",
+ "onPremisesUserPrincipalName": "String",
+ "otherMails": ["String"],
+ "passwordPolicies": "String",
"passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
- "pastProjects": ["string"],
- "postalCode": "string",
- "preferredDataLocation": "string",
- "preferredLanguage": "string",
- "preferredName": "string",
+ "pastProjects": ["String"],
+ "postalCode": "String",
+ "preferredDataLocation": "String",
+ "preferredLanguage": "String",
+ "preferredName": "String",
"provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
- "proxyAddresses": ["string"],
+ "proxyAddresses": ["String"],
"refreshTokensValidFromDateTime": "2019-02-07T21:53:13.084Z",
- "responsibilities": ["string"],
- "schools": ["string"],
+ "responsibilities": ["String"],
+ "schools": ["String"],
"showInAddressList": true, "signInSessionsValidFromDateTime": "2019-02-07T21:53:13.084Z",
- "skills": ["string"],
- "state": "string",
- "streetAddress": "string",
- "surname": "string",
- "usageLocation": "string",
- "userPrincipalName": "string",
- "userType": "string",
+ "skills": ["String"],
+ "state": "String",
+ "streetAddress": "String",
+ "surname": "String",
+ "usageLocation": "String",
+ "userPrincipalName": "String",
+ "userType": "String",
"calendar": {"@odata.type": "microsoft.graph.calendar"}, "calendarGroups": [{"@odata.type": "microsoft.graph.calendarGroup"}], "calendarView": [{"@odata.type": "microsoft.graph.event"}],
v1.0 Device Delete https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/device-delete.md
One of the following permissions is required to call this API. To learn more, in
|Application | Not supported. | ## HTTP request+
+The `{id}` in the request is the value of the **id** property of the device, not the **deviceId** property.
<!-- { "blockType": "ignored" } --> ```http DELETE /devices/{id} ```
-> Note: The "id" in the request is the "id" property of the device, not the "deviceId" property.
## Request headers | Name | Type | Description|
v1.0 Device Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/device-get.md
One of the following permissions is required to call this API. To learn more, in
|Application | Device.Read.All, Device.ReadWrite.All, Directory.Read.All, Directory.ReadWrite.All | ## HTTP request+
+The `{id}` in the request is the value of the **id** property of the device, not the **deviceId** property.
<!-- { "blockType": "ignored" } --> ```http GET /devices/{id} ```
-> Note: The "id" in the request is the "id" property of the device, not the "deviceId" property.
## Optional query parameters This method supports the `$select` [OData query parameter](/graph/query-parameters) to help customize the response.
v1.0 Device Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/device-update.md
One of the following permissions is required to call this API. To learn more, in
|Application | Device.ReadWrite.All, Directory.ReadWrite.All | ## HTTP request+
+The `{id}` in the request is the value of the **id** property of the device, not the **deviceId** property.
<!-- { "blockType": "ignored" } --> ```http PATCH /devices/{id} ```
-> Note: The "id" in the request is the "id" property of the device, not the "deviceId" property.
+ ## Request headers | Name | Type | Description|
In the request body, supply the values for the [device](../resources/device.md)
| Property | Type |Description| |:|:--|:-|
-|accountEnabled|Boolean| **true** if the account is enabled; otherwise, **false**. |
+|accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. Only callers in Global Administrator and Cloud Device Administrator roles can update this property.|
|operatingSystem|String|The type of operating system on the device.| |operatingSystemVersion|String|The version of the operating system on the device| |displayName|String|The display name for the device.|
-|isCompliant|Boolean|**true** if the device complies with Mobile Device Management (MDM) policies; otherwise, **false**. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
-|isManaged|Boolean|**true** if the device is managed by a Mobile Device Management (MDM) app; otherwise, **false**. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
+|isCompliant|Boolean|`true` if the device complies with Mobile Device Management (MDM) policies; otherwise, `false`. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
+|isManaged|Boolean|`true` if the device is managed by a Mobile Device Management (MDM) app; otherwise, `false`. This can only be updated by Intune for any device OS type or by an [approved MDM app](/windows/client-management/mdm/azure-active-directory-integration-with-mdm) for Windows OS devices. |
## Response
v1.0 Directoryaudit List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/directoryaudit-list.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) | AuditLog.Read.All and Directory.Read.All |
-| Delegated (personal Microsoft account) | Not supported |
+| Delegated (personal Microsoft account) | Not supported. |
| Application | AuditLog.Read.All and Directory.Read.All | > [!IMPORTANT]
v1.0 Accessreviewsv2 Root https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/accessreviewsv2-root.md
doc_type: conceptualPageType
Namespace: microsoft.graph
+Use [Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-access-reviews-overview) to configure one-time or recurring access reviews for attestation of users' rights to access Azure AD resources. These Azure AD resources include groups, service principals, access packages, and privileged roles.
-Use [Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-access-reviews-overview) to configure one-time or recurring access reviews for attestation of user's access rights to Azure AD resources.
+Typical customer scenarios for access reviews include:
-Typical customer scenarios for access reviews of group memberships and application and Azure AD role access are:
--- Customers can review and certify guest user access to applications, Azure AD roles, and memberships of groups. Reviewers can use the insights that are provided to efficiently decide whether guests should have continued access.--- Customers can review and certify employee access to applications, Azure AD roles, and group memberships with access reviews.
+- Customers can review and certify guest user access to groups through group memberships. Reviewers can use the insights that are provided to efficiently decide whether guests should have continued access.
+- Customers can review and certify employee access to Azure AD resources.
+- Customers can review and audit assignments to Azure AD privileged roles. This supports organizations in the management of privileged access.
The access reviews feature, including the API, is available only with a valid purchase or trial license of Azure AD Premium P2 or EMS E5 subscription. - ## Methods The following table lists the methods that you can use to interact with access review-related resources.
The following table lists the methods that you can use to interact with access r
## Role and application permission authorization checks
-The following directory roles are required for a calling user to manage access reviews.
+The following [Azure AD roles](/azure/active-directory/roles/permissions-reference) are required for a calling user to manage access reviews.
| Operation | Application permissions | Required directory role of the calling user | |:|:|:--|
In addition, a user who is an assigned reviewer of an access review can manage t
## See also
+- [Tutorials](/graph/accessreviews-overview) to learn how to use the access reviews API to review access to Azure AD resources
- [How an administrator can manage user access with Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-manage-user-access-with-access-reviews)-- [How an administrator can manage guest access with Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-manage-guest-access-with-access-reviews)
+- [How an administrator can manage guest access with Azure AD access reviews](/azure/active-directory/active-directory-azure-ad-controls-manage-guest-access-with-access-reviews)
v1.0 Device https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/device.md
This resource lets you add your own data to custom properties using [extensions]
| Property | Type |Description| |:|:--|:-|
-|accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. Required. Default is `true`. Supports `$filter` (`eq`, `ne`, `NOT`, `in`).|
+|accountEnabled|Boolean| `true` if the account is enabled; otherwise, `false`. Required. Default is `true`. <br/><br/> Supports `$filter` (`eq`, `ne`, `NOT`, `in`). Only callers in Global Administrator and Cloud Device Administrator roles can set this property.|
|alternativeSecurityIds|[alternativeSecurityId](alternativeSecurityId.md) collection| For internal use only. Not nullable. Supports `$filter` (`eq`, `NOT`, `ge`, `le`).| |approximateLastSignInDateTime|DateTimeOffset| 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. Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`) and `$orderBy`. | |complianceExpirationDateTime|DateTimeOffset| The timestamp when the device is no longer deemed compliant. 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. |
v1.0 User https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/user.md
This resource supports:
|passwordProfile|[passwordProfile](passwordprofile.md)|Specifies the password profile for the user. The profile contains the userΓÇÖs password. This property is required when a user is created. The password in the profile must satisfy minimum requirements as specified by the **passwordPolicies** property. By default, a strong password is required. **NOTE:** For Azure B2C tenants, the **forceChangePasswordNextSignIn** property should be set to `false` and instead use custom policies and user flows to force password reset at first logon. See [Force password reset at first logon](https://github.com/azure-ad-b2c/samples/tree/master/policies/force-password-reset-first-logon).<br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, `in`).| |pastProjects|String collection|A list for the user to enumerate their past projects. <br><br>Returned only on `$select`.| |postalCode|String|The postal code for the user's postal address. The postal code is specific to the user's country/region. In the United States of America, this attribute contains the ZIP code. Maximum length is 40 characters. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`).|
+| preferredDataLocation | String | The preferred data location for the user. For more information, see [OneDrive Online Multi-Geo](/sharepoint/dev/solution-guidance/multigeo-introduction).|
|preferredLanguage|String|The preferred language for the user. Should follow ISO 639-1 Code; for example `en-US`. <br><br>Returned by default. Supports `$filter` (`eq`, `ne`, `NOT`, `ge`, `le`, `in`, `startsWith`)| |preferredName|String|The preferred name for the user. <br><br>Returned only on `$select`.| |provisionedPlans|[provisionedPlan](provisionedplan.md) collection|The plans that are provisioned for the user. Read-only. Not nullable. <br><br>Returned only on `$select`. Supports `$filter` (`eq`, `NOT`, `ge`, `le`).|
Here is a JSON representation of the resource
```json {
- "aboutMe": "string",
+ "aboutMe": "String",
"accountEnabled": true,
- "ageGroup": "string",
+ "ageGroup": "String",
"assignedLicenses": [{"@odata.type": "microsoft.graph.assignedLicense"}], "assignedPlans": [{"@odata.type": "microsoft.graph.assignedPlan"}], "birthday": "String (timestamp)",
- "businessPhones": ["string"],
- "city": "string",
- "companyName": "string",
- "consentProvidedForMinor": "string",
- "country": "string",
+ "businessPhones": ["String"],
+ "city": "String",
+ "companyName": "String",
+ "consentProvidedForMinor": "String",
+ "country": "String",
"createdDateTime": "String (timestamp)",
- "creationType": "string",
- "department": "string",
- "displayName": "string",
+ "creationType": "String",
+ "department": "String",
+ "displayName": "String",
"employeeHireDate": "2020-01-01T00:00:00Z",
- "employeeId": "string",
+ "employeeId": "String",
"employeeOrgData": {"@odata.type": "microsoft.graph.employeeOrgData"},
- "employeeType": "string",
- "faxNumber" : "string",
- "givenName": "string",
+ "employeeType": "String",
+ "faxNumber" : "String",
+ "givenName": "String",
"hireDate": "String (timestamp)",
- "id": "string (identifier)",
+ "id": "String (identifier)",
"identities": [{"@odata.type": "microsoft.graph.objectIdentity"}],
- "imAddresses": ["string"],
- "interests": ["string"],
+ "imAddresses": ["String"],
+ "interests": ["String"],
"isResourceAccount": false,
- "jobTitle": "string",
- "legalAgeGroupClassification": "string",
+ "jobTitle": "String",
+ "legalAgeGroupClassification": "String",
"licenseAssignmentStates": [{"@odata.type": "microsoft.graph.licenseAssignmentState"}], "lastPasswordChangeDateTime": "String (timestamp)",
- "mail": "string",
+ "mail": "String",
"mailboxSettings": {"@odata.type": "microsoft.graph.mailboxSettings"},
- "mailNickname": "string",
- "mobilePhone": "string",
- "mySite": "string",
- "officeLocation": "string",
- "onPremisesDistinguishedName": "string",
- "onPremisesDomainName": "string",
+ "mailNickname": "String",
+ "mobilePhone": "String",
+ "mySite": "String",
+ "officeLocation": "String",
+ "onPremisesDistinguishedName": "String",
+ "onPremisesDomainName": "String",
"onPremisesExtensionAttributes": {"@odata.type": "microsoft.graph.onPremisesExtensionAttributes"},
- "onPremisesImmutableId": "string",
+ "onPremisesImmutableId": "String",
"onPremisesLastSyncDateTime": "String (timestamp)", "onPremisesProvisioningErrors": [{"@odata.type": "microsoft.graph.onPremisesProvisioningError"}],
- "onPremisesSamAccountName": "string",
- "onPremisesSecurityIdentifier": "string",
+ "onPremisesSamAccountName": "String",
+ "onPremisesSecurityIdentifier": "String",
"onPremisesSyncEnabled": true,
- "onPremisesUserPrincipalName": "string",
- "otherMails": ["string"],
- "passwordPolicies": "string",
+ "onPremisesUserPrincipalName": "String",
+ "otherMails": ["String"],
+ "passwordPolicies": "String",
"passwordProfile": {"@odata.type": "microsoft.graph.passwordProfile"},
- "pastProjects": ["string"],
- "postalCode": "string",
- "preferredLanguage": "string",
- "preferredName": "string",
+ "pastProjects": ["String"],
+ "postalCode": "String",
+ "preferredDataLocation": "String",
+ "preferredLanguage": "String",
+ "preferredName": "String",
"provisionedPlans": [{"@odata.type": "microsoft.graph.provisionedPlan"}],
- "proxyAddresses": ["string"],
- "responsibilities": ["string"],
- "schools": ["string"],
+ "proxyAddresses": ["String"],
+ "responsibilities": ["String"],
+ "schools": ["String"],
"showInAddressList": true, "signInSessionsValidFromDateTime": "String (timestamp)",
- "skills": ["string"],
- "state": "string",
- "streetAddress": "string",
- "surname": "string",
- "usageLocation": "string",
- "userPrincipalName": "string",
- "userType": "string",
+ "skills": ["String"],
+ "state": "String",
+ "streetAddress": "String",
+ "surname": "String",
+ "usageLocation": "String",
+ "userPrincipalName": "String",
+ "userType": "String",
"calendar": { "@odata.type": "microsoft.graph.calendar" }, "calendarGroups": [{ "@odata.type": "microsoft.graph.calendarGroup" }],