Updates from: 03/11/2021 04:12:08
Service Microsoft Docs article Related commit history on GitHub Change details
v1.0 Claimsmappingpolicy List Appliesto https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/claimsmappingpolicy-list-appliesto.md
The following is an example of the request.
}--> ```http
-GET https://graph.microsoft.com/beta/claimsMappingPolicies/{id}/appliesTo
+GET https://graph.microsoft.com/beta/policies/claimsMappingPolicies/{id}/appliesTo
``` ### Response
v1.0 Directorysetting List https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/directorysetting-list.md
One of the following permissions is required to call this API. To learn more, in
List tenant-wide or group settings ```http GET /settings
-GET /group/{id}/settings
+GET /groups/{id}/settings
``` ## Optional query parameters This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.
v1.0 Ediscovery Case Get https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-case-get.md
The following is an example of the request.
}--> ```http
-GET https://graph.microsoft.com/beta/cases/061b9a92-8926-4bd9-b41d-abf35edc7583
+GET https://graph.microsoft.com/beta/compliance/ediscovery/cases/061b9a92-8926-4bd9-b41d-abf35edc7583
``` ### Response
v1.0 Ediscovery Reviewset Addtoreviewset https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/ediscovery-reviewset-addtoreviewset.md
One of the following permissions is required to call this API. To learn more, in
--> ``` http
-POST /cases/{caseId}/reviewSets/{reviewsetId}/addToReviewSet
+POST /compliance/ediscovery/cases/{caseId}/reviewSets/{reviewsetId}/addToReviewSet
``` ## Request headers
v1.0 Notebook Getrecentnotebooks https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/notebook-getrecentnotebooks.md
The following example shows how to call this API.
The following example shows the request. <!-- { "blockType": "request", "name": "recent_notebooks", "scopes": "notes.read" } --> ```http
-GET https://graph.microsoft.com/v1.0/onenote/notebooks/getrecentnotebooks(includePersonalNotebooks=true)
+GET https://graph.microsoft.com/v1.0/me/onenote/notebooks/getrecentnotebooks(includePersonalNotebooks=true)
``` ##### Response
v1.0 Privilegedapproval Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/privilegedapproval-update.md
Here is an example of the request.
"name": "update_privilegedapproval" }--> ```http
-PATCH https://graph.microsoft.com/beta/privilegedApproval{request-id}
+PATCH https://graph.microsoft.com/beta/privilegedApproval/{requestId}
Content-type: application/json Content-length: 180
v1.0 Privilegedroleassignmentrequest Cancel https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/privilegedroleassignmentrequest-cancel.md
One of the following permissions is required to call this API. To learn more, in
### HTTP request <!-- { "blockType": "ignored" } --> ```http
-POST /privilegedRoleAssignmentRequests({requestid})/cancel
+POST /privilegedRoleAssignmentRequests/{requestid}/cancel
``` ## Request headers
v1.0 Program Listcontrols https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/program-listcontrols.md
One of the following permissions is required to call this API. To learn more, in
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-GET /programs('{programId}')/controls
+GET /programs/{programId}/controls
``` ## Request headers | Name | Type | Description |
v1.0 Program Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/program-update.md
The signed in user must also be in a directory role that permits them to update
## HTTP request <!-- { "blockType": "ignored" } --> ```http
-PATCH /programs('{programId}')
+PATCH /programs/{programId}
``` ## Request headers | Name | Type | Description |
v1.0 Subscriptions Socketio https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/subscriptions-socketio.md
To learn more, including how to choose permissions, see [Permissions](/graph/per
```http GET /me/drive/root/subscriptions/socketIo GET /drives/{driveId}/root/subscriptions/socketIo
-GET /lists/{list-id}/subscriptions/socketIo
+GET /drives/{driveId}/list/subscriptions/socketIo
GET /groups/{groupId}/drive/root/subscriptions/socketIo GET /sites/{siteId}/lists/{listId}/drive/root/subscriptions/socketIo ```
v1.0 Synchronization Synchronizationtemplate Update https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/api/synchronization-synchronizationtemplate-update.md
One of the following permissions is required to call this API. To learn more, in
### HTTP Request <!-- { "blockType": "ignored" } --> ```http
-PATCH application/{id}/synchronization/templates/{templateId}
+PATCH applications/{id}/synchronization/templates/{templateId}
``` ## Request headers
v1.0 Regionalandlanguagesettings https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/regionalandlanguagesettings.md
An open type that represents a user's preferences for languages in various conte
| Property | Type | Description | |-|-|| | defaultDisplayLanguage | [localeInfo](localeinfo.md) | The user's preferred user interface language (menus, buttons, ribbons, warning messages) for Microsoft web applications.<br><br>Returned by default. Not nullable. |
-| authoringLanguages | localeInfo collection | Prioritized list of languages the user reads and authors in.<br><br>Returned by default. Not nullable. |
-| defaultTranslationLanguage | localeInfo | The language a user expects to have documents, emails, and messages translated into.<br><br>Returned by default. |
-| defaultSpeechInputLanguage | localeInfo | The language a user expected to use as input for text to speech scenarios.<br><br>Returned by default. |
-| defaultRegionalFormat | localeInfo | The locale that drives the default date, time, and calendar formatting.<br><br>Returned by default. |
+| authoringLanguages | [localeInfo](localeinfo.md) collection | Prioritized list of languages the user reads and authors in.<br><br>Returned by default. Not nullable. |
+| defaultTranslationLanguage | [localeInfo](localeinfo.md) | The language a user expects to have documents, emails, and messages translated into.<br><br>Returned by default. |
+| defaultSpeechInputLanguage | [localeInfo](localeinfo.md) | The language a user expected to use as input for text to speech scenarios.<br><br>Returned by default. |
+| defaultRegionalFormat | [localeInfo](localeinfo.md) | The locale that drives the default date, time, and calendar formatting.<br><br>Returned by default. |
| regionalFormatOverrides | [regionalFormatOverrides](regionalformatoverrides.md) | Allows a user to override their defaultRegionalFormat with field specific formats.<br><br>Returned by default. | | translationPreferences | [translationPreferences](translationPreferences.md) | The user's preferred settings when consuming translated documents, emails, messages, and websites.<br><br>Returned by default. Not nullable. |
v1.0 Signinactivity https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/beta/resources/signinactivity.md
Provides the last signed-in date for a specific [user](user.md).
| Property | Type | Description | |:-|:|:|
-|lastSignInDateTime|DateTimeOffset|The last sign-in date for a specific user. You can use this field to calculate the last time a user signed in to the directory. This field can be used to build reports, such as inactive users. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: `'2014-01-01T00:00:00Z'`. For more information about using the value of this property, see [Manage inactive user accounts in Azure AD](/azure/active-directory/reports-monitoring/howto-manage-inactive-user-accounts).|
+|lastSignInDateTime|DateTimeOffset|The last interactive sign-in date for a specific user. You can use this field to calculate the last time a user signed in to the directory with an interactive authentication method. This field can be used to build reports, such as inactive users. The timestamp represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: `'2014-01-01T00:00:00Z'`. For more information about using the value of this property, see [Manage inactive user accounts in Azure AD](/azure/active-directory/reports-monitoring/howto-manage-inactive-user-accounts).|
|lastSignInRequestId|String|Request ID of the last sign-in performed by this user.| ## JSON representation
The following is a JSON representation of the resource.
"keywords": "", "section": "documentation", "tocPath": ""
-}-->
+}-->
v1.0 Organizationalbrandingproperties Create https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/api/organizationalbrandingproperties-create.md
+
+ Title: "Create organizationalBrandingProperties"
+description: "Create organization branding."
+localization_priority: Normal
+++
+# Create organizationalBrandingProperties
+
+Create an [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object. This creates the default branding and optionally a localized branding. 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 overwrites all existing values regardless of what's in the request body. PATCH only overwrites 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/{id}/branding
+PATCH /organization/{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, include a JSON representation of an [organizationalBrandingProperties](../resources/organizationalbrandingproperties.md) object. The following table lists the required properties.
+
+| Property | Type | Description |
+|:-|:|:|
+|backgroundColor|String|Color that appears 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. The image is a .png or .jpg that is 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 that appears on the sign-in page. The banner is a .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. The logo is a .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|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 where **Content-Language** is `en-US`.
+
+### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbrandingproperties"
+}-->
+
+```http
+PUT https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
+Content-Type: application/json
+Content-Language: en-US
+
+{
+ "backgroundColor":"#FFFF33",
+ "signInPageText":"Welcome",
+ "usernameHintText":"hint"
+}
+```
+
+### 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/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/backgroundImage",
+ "backgroundImage@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/en-US/backgroundImage",
+ "bannerLogo@odata.mediaContentType":"image/*",
+ "bannerLogo@odata.mediaReadLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo",
+ "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/en-US/bannerLogo",
+ "id": "und",
+ "signInPageText":"Welcome",
+ "squareLogo@odata.mediaContentType":"image/*",
+ "squareLogo@odata.mediaReadLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/squareLogo",
+ "squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/en-US/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** header, even though the `en-US` branding set is not returned in the response. The **Content-Language** header in the request is optional, and if not present, only sets the 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/v1.0/api/organizationalbrandingproperties-delete.md
+
+ Title: "Delete organizationalBrandingProperties"
+description: "Delete organizationalBrandingProperties."
+localization_priority: Normal
+++
+# 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/{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.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_organizationalbrandingproperties"
+}-->
+
+```http
+DELETE https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
+```
+
+### 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/v1.0/api/organizationalbrandingproperties-get.md
+
+ Title: "Get organizationalBrandingProperties"
+description: "Retrieve the properties and relationships of an organizationalBrandingProperties object."
+localization_priority: Normal
+++
+# 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/{id}/branding/{property name}
+```
+
+## 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.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbrandingproperties"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
+```
+
+#### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "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/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/backgroundImage",
+ "backgroundImage@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/backgroundImage",
+ "bannerLogo@odata.mediaContentType":"image/*",
+ "bannerLogo@odata.mediaReadLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo",
+ "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo",
+ "id": "und",
+ "squareLogo@odata.mediaContentType":"image/*",
+ "squareLogo@odata.mediaReadLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/squareLogo",
+ "squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/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"
+}-->
+
+```http
+GET https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties"
+} -->
+
+```http
+HTTP/1.1 404 NOT FOUND
+```
+
+### Example 3: Get organizational branding for the French locale
+The **Accept-Language** 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"
+}-->
+
+```http
+GET https://graph.microsoft.com/v1.0/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. All the properties will be returned from an actual call.
+
+<!-- {
+ "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/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/backgroundImage",
+ "backgroundImage@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/backgroundImage",
+ "bannerLogo@odata.mediaContentType":"image/*",
+ "bannerLogo@odata.mediaReadLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo",
+ "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/bannerLogo",
+ "id": "und",
+ "squareLogo@odata.mediaContentType":"image/*",
+ "squareLogo@odata.mediaReadLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/squareLogo",
+ "squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/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.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbrandingproperties"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo
+Accept-Language: fr
+```
+
+#### 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/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo",
+ "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/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.
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbrandingproperties"
+}-->
+
+```http
+GET https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo
+Accept-Language: de
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties"
+} -->
+
+```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/v1.0/api/organizationalbrandingproperties-update.md
+
+ Title: "Update organizationalBrandingProperties"
+description: "Update the properties of an organizationalBrandingProperties object."
+localization_priority: Normal
+++
+# 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/{id}/branding/{property name}
+PUT /organization/{id}/branding/{property name}
+```
+
+## 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 No Content` 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.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_organizationalbrandingproperties"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/v1.0/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",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties"
+} -->
+
+```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"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/bannerLogo
+Content-Type: image/jpeg
+
+<Image>
+```
+
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties"
+} -->
+
+```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 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"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/v1.0/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",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties"
+} -->
+
+```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.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_organizationalbrandingproperties"
+}-->
+
+```http
+PUT https://graph.microsoft.com/v1.0/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",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties"
+} -->
+
+```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/v1.0/api/organizationalbrandingpropertieslocalization-create.md
+
+ Title: "Create localized organizationalBrandingProperties"
+description: "Create organization branding for a specific locale."
+localization_priority: Normal
+++
+# 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/{id}/branding/localizations
+```
+
+## 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.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbrandingproperties"
+}-->
+
+```http
+POST https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations
+Content-Type: application/json
+
+{
+ "backgroundColor":"#00000F",
+ "id": "fr"
+}
+```
+
+### 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/v1.0/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/v1.0/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/v1.0/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/v1.0/api/organizationalbrandingpropertieslocalization-delete.md
+
+ Title: "Delete localized organizationalBrandingProperties"
+description: "Delete organizationalBrandingProperties for a specific localization."
+localization_priority: Normal
+++
+# 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/{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.
+
+<!-- {
+ "blockType": "request",
+ "name": "delete_organizationalbrandingproperties"
+}-->
+
+```http
+DELETE https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr
+```
+
+### 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/v1.0/api/organizationalbrandingpropertieslocalization-get.md
+
+ Title: "Get localized organizationalBrandingProperties"
+description: "Retrieve organizationalbrandingproperties object for a specific locale."
+localization_priority: Normal
+++
+# 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/{id}/branding/localizations/{locale}/{property name}
+```
+
+## 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.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbrandingproperties"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr
+```
+
+#### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "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/v1.0/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/v1.0/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/v1.0/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.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbrandingproperties"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations
+```
+
+#### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "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/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/en-US/backgroundImage",
+ "backgroundImage@odata.mediaEditLink":"https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/en-US/backgroundImage",
+ "bannerLogo@odata.mediaContentType":"image/*",
+ "bannerLogo@odata.mediaReadLink": null,
+ "bannerLogo@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/en-US/bannerLogo",
+ "id":"en-us",
+ "squareLogo@odata.mediaContentType":"image/*",
+ "squareLogo@odata.mediaReadLink": null,
+ "squareLogo@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/en-US/squareLogo",
+ "signInPageText":"Welcome",
+ "usernameHintText":"hint"
+ },
+ {
+ "backgroundColor":"#00000F",
+ "backgroundImage@odata.mediaContentType":"image/*",
+ "backgroundImage@odata.mediaReadLink": null,
+ "backgroundImage@odata.mediaEditLink": "https://graph.microsoft.com/v1.0/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/v1.0/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/v1.0/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.
+
+<!-- {
+ "blockType": "request",
+ "name": "get_organizationalbrandingproperties"
+}-->
+
+```msgraph-interactive
+GET https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/en-US/signInPageText
+```
+
+#### Response
+
+The following is an example of the response.
+
+> **Note:** The response object shown here might be shortened for readability. All the properties will be returned from an actual call.
+
+<!-- {
+ "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/v1.0/api/organizationalbrandingpropertieslocalization-update.md
+
+ Title: "Update localized organizationalbrandingproperties"
+description: "Update the properties of the organizationalbrandingproperties object for a specific localization."
+localization_priority: Normal
+++
+# 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/{id}/branding/localizations/{locale}/{property name}
+PUT /organization/{id}/branding/localizations/{locale}/{property name}
+```
+
+## 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, a `404 not found` error is returned. If the payload contains an `id` property or **Content-Language** header, and they don't match `id` in URL, a `Bad Request` error is returned.
+
+#### Request
+
+The following is an example of the request.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_organizationalbrandingproperties"
+}-->
+
+```http
+PUT https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr/bannerLogo
+Content-Type: image/jpeg
+
+<Image>
+```
+
+#### Response
+
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties"
+} -->
+
+```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.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_organizationalbrandingproperties"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr
+Content-Type: application/json
+
+{
+ "backgroundColor":"#00000F",
+ "signInPageText": "fr"
+}
+```
+
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties"
+} -->
+
+```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"
+}-->
+
+```http
+PATCH https://graph.microsoft.com/v1.0/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",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties"
+} -->
+
+```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.
+
+<!-- {
+ "blockType": "request",
+ "name": "update_organizationalbrandingproperties"
+}-->
+
+```http
+PUT https://graph.microsoft.com/v1.0/organization/d69179bf-f4a4-41a9-a9de-249c0f2efb1d/branding/localizations/fr
+Content-Type: application/json
+
+{
+ "backgroundColor":"#00000F",
+ "signInPageText": "fr"
+}
+```
+
+#### Response
+The following is an example of the response.
+
+<!-- {
+ "blockType": "response",
+ "truncated": true,
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties"
+} -->
+
+```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 Azure Ad Overview https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/azure-ad-overview.md
Title: "Working with Azure Active Directory resources in Microsoft Graph"
description: "With Microsoft Graph, you can access Azure Active Directory (Azure AD) resources to enable scenarios like managing administrator (directory) roles, inviting external users to an organization, and, if you are a Cloud Solution Provider (CSP), managing your customer's data. Microsoft Graph also provides methods that apps can use to, for example, discover information about users' transitive group and role memberships. " localization_priority: Priority doc_type: conceptualPageType
The following table lists some common use cases for Azure AD resources.
| Get information about an organization, such as its business address, technical and notification contacts, the service plans that it's subscribed to, and the domains associated with it. | [organization](../resources/organization.md) | N/A | | Get information about the service SKUs that a company is subscribed to. | [subscribedSku](../resources/subscribedsku.md) | N/A | | Invite external (guest) users to an organization. | [invitation](../resources/invitation.md) | [What is Azure AD B2B collaboration?](/azure/active-directory/active-directory-b2b-what-is-azure-ad-b2b) |
+| Manage branding for the sign-in experience of an organization. | [organizationalbranding](../resources/organizationalbrandingproperties.md) | [Add branding to your organization's Azure Active Directory sign-in page](https://docs.microsoft.com/azure/active-directory/fundamentals/customize-branding)|
## What's new Find out about the [latest new features and updates](/graph/whats-new-overview) for this API set.
v1.0 Organization https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/organization.md
This resource lets you add your own data to custom properties using [extensions]
|[Get open extension](../api/opentypeextension-get.md) |[openTypeExtension](opentypeextension.md) collection| Get an open extension identified by the extension name.| |**Schema extensions**| |[Add schema extension values](/graph/extensibility-schema-groups) || Create a schema extension definition and then use it to add custom typed data to a resource.|
+| [Get branding](../api/organizationalbrandingproperties-get.md) | [organizationalBrandingProperties](organizationalbrandingproperties.md) collection | Get a organizationalBrandingProperties object collection. |
## Properties
This resource lets you add your own data to custom properties using [extensions]
| city | String | City name of the address for the organization. | | country | String | Country/region name of the address for the organization. | | countryLetterCode | String | Country/region abbreviation for the organization. |
-| createdDateTime | DateTimeOffset | Timestamp of when the organization was created. The value cannot be modified and is automatically populated when the organization is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: `'2014-01-01T00:00:00Z'`. Read-only. |
-| deletedDateTime | DateTimeOffset | Represents date and time of when the Azure AD tenant was deleted using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: `'2014-01-01T00:00:00Z'`. Read-only. |
-| createdDateTime | DateTimeOffset | Timestamp of when the organization was created. The value cannot be modified and is automatically populated when the organization is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: `'2014-01-01T00:00:00Z'`. Read-only. |
+| createdDateTime | DateTimeOffset | Timestamp of when the organization was created. The value cannot be modified and is automatically populated when the organization is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. |
+| deletedDateTime | DateTimeOffset | Represents date and time of when the Azure AD tenant was deleted using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. |
+| createdDateTime | DateTimeOffset | Timestamp of when the organization was created. The value cannot be modified and is automatically populated when the organization is created. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. |
| displayName | String | The display name for the tenant. | | id | String | The tenant ID, a unique identifier representing the organization (or tenant). Inherited from [directoryObject](directoryobject.md). Key. Not nullable. Read-only. | | isMultipleDataLocationsForServicesEnabled | Boolean | **true** if organization is Multi-Geo enabled; **false** if organization is not Multi-Geo enabled; **null** (default). Read-only. For more information, see [OneDrive Online Multi-Geo](/sharepoint/dev/solution-guidance/multigeo-introduction). | | marketingNotificationEmails | String collection | Not nullable. |
-| onPremisesLastSyncDateTime | DateTimeOffset | The time and date at which the tenant was last synced with the on-premise directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 would look like this: `'2014-01-01T00:00:00Z'`. Read-only. |
+| onPremisesLastSyncDateTime | DateTimeOffset | The time and date at which the tenant was last synced with the on-premise directory. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is `2014-01-01T00:00:00Z`. Read-only. |
| onPremisesSyncEnabled | Boolean | **true** if this object is synced from an on-premises directory; **false** if this object was originally synced from an on-premises directory but is no longer synced; **null** if this object has never been synced from an on-premises directory (default). | | postalCode | String | Postal code of the address for the organization. | | preferredLanguage | String | The preferred language for the organization. Should follow ISO 639-1 Code; for example "en". |
This resource lets you add your own data to custom properties using [extensions]
|:|:--|:-| |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. Read-only. Nullable.|
+|organizationalBranding|[organizationalBrandingProperties](organizationalbrandingproperties.md) collection| Branding for the organization. Nullable.|
## JSON representation
v1.0 Organizationalbrandingproperties https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/resources/organizationalbrandingproperties.md
+
+ Title: "organizationalBrandingProperties resource type"
+description: "Contains details of the organization's branding."
+localization_priority: Normal
+++
+# organizationalBrandingProperties resource type
+
+>[!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](https://docs.microsoft.com/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.
+
+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.
+
+Companies can add different branding based on locale. Locale serves as a key in all requests.
+
+>**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**.
+
+## 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. |
+
+## 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. |
+
+## Relationships
+
+None
+
+## JSON representation
+
+The following is a JSON representation of the resource.
+
+<!-- {
+ "blockType": "resource",
+ "optionalProperties": [
+
+ ],
+ "@odata.type": "microsoft.graph.organizationalBrandingProperties",
+ "keyProperty": "id"
+}-->
+
+```json
+{
+ "backgroundColor": "String",
+ "backgroundImage": "Stream",
+ "bannerLogo": "Stream",
+ "id": "String (identifier)",
+ "signInPageText": "String",
+ "squareLogo": "Stream",
+ "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 Toc.Yml https://github.com/microsoftgraph/microsoft-graph-docs/commits/master/api-reference/v1.0/toc.yml a/api-reference/v1.0/toc.yml
items:
items: - name: Create invitation href: api/invitation-post.md
+ - name: Organizational branding
+ href: resources/organizationalbrandingproperties.md
+ items:
+ - name: Create
+ href: api/organizationalbrandingproperties-create.md
+ - name: Get
+ href: api/organizationalbrandingproperties-get.md
+ - name: Update
+ href: api/organizationalbrandingproperties-update.md
+ - name: Delete
+ href: api/organizationalbrandingproperties-delete.md
+ - name: Create localized
+ href: api/organizationalbrandingpropertieslocalization-create.md
+ - name: Get localized
+ href: api/organizationalbrandingpropertieslocalization-get.md
+ - name: Update localized
+ href: api/organizationalbrandingpropertieslocalization-update.md
+ - name: Delete localized
+ href: api/organizationalbrandingpropertieslocalization-delete.md
- name: Policy href: resources/policy-overview.md items:
items:
- name: Add named item href: api/nameditem-add.md - name: List range
- href: api/nameditem-range.md
+ href: api/nameditem-range.md