-With the exception of the **policyViolation** property, all properties of a **chatMessage** can be updated in delegated permissions scenarios.

-description: "Not yet documented"

-localization_priority: Normal

-doc_type: apiPageType

-# getOrganizationalMessageTenantConsent function

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Not yet documented

-## Prerequisites

-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)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-GET /deviceManagement/getOrganizationalMessageTenantConsent

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-Do not supply a request body for this method.

-## Response

-If successful, this function returns a `200 OK` response code and a [organizationalMessageTenantConsent](../resources/intune-partnerintegration-organizationalmessagetenantconsent.md) in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-GET https://graph.microsoft.com/beta/deviceManagement/getOrganizationalMessageTenantConsent

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 200 OK

-Content-Type: application/json

-Content-Length: 135

-{

- "value": {

- "@odata.type": "microsoft.graph.organizationalMessageTenantConsent",

- "firstPartyMessageAllowed": true

- }

-}

-```

-description: "Not yet documented"

-localization_priority: Normal

-doc_type: apiPageType

-# postOrganizationalMessageTenantConsent action

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Not yet documented

-## Prerequisites

-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)|DeviceManagementConfiguration.Read.All, DeviceManagementApps.Read.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementApps.Read.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-POST /deviceManagement/postOrganizationalMessageTenantConsent

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-In the request body, supply JSON representation of the parameters.

-The following table shows the parameters that can be used with this action.

-|Property|Type|Description|

-|:|:|:|

-|firstPartyMessageAllowed|Boolean|Not yet documented|

-## Response

-If successful, this action returns a `200 OK` response code and a [organizationalMessageTenantConsent](../resources/intune-partnerintegration-organizationalmessagetenantconsent.md) in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-POST https://graph.microsoft.com/beta/deviceManagement/postOrganizationalMessageTenantConsent

-Content-type: application/json

-Content-length: 40

-{

- "firstPartyMessageAllowed": true

-}

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 200 OK

-Content-Type: application/json

-Content-Length: 135

-{

- "value": {

- "@odata.type": "microsoft.graph.organizationalMessageTenantConsent",

- "firstPartyMessageAllowed": true

- }

-}

-```

-description: "Not yet documented"

-localization_priority: Normal

-doc_type: apiPageType

-# updateOrganizationalMessageTenantConsent action

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Not yet documented

-## Prerequisites

-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)|DeviceManagementConfiguration.Read.All, DeviceManagementApps.Read.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementApps.Read.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-POST /deviceManagement/updateOrganizationalMessageTenantConsent

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-In the request body, supply JSON representation of the parameters.

-The following table shows the parameters that can be used with this action.

-|Property|Type|Description|

-|:|:|:|

-|firstPartyMessageAllowed|Boolean|Not yet documented|

-## Response

-If successful, this action returns a `200 OK` response code and a [organizationalMessageTenantConsent](../resources/intune-partnerintegration-organizationalmessagetenantconsent.md) in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-POST https://graph.microsoft.com/beta/deviceManagement/updateOrganizationalMessageTenantConsent

-Content-type: application/json

-Content-length: 40

-{

- "firstPartyMessageAllowed": true

-}

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 200 OK

-Content-Type: application/json

-Content-Length: 135

-{

- "value": {

- "@odata.type": "microsoft.graph.organizationalMessageTenantConsent",

- "firstPartyMessageAllowed": true

- }

-}

-```

-description: "Create a new organizationalMessageDetail object."

-localization_priority: Normal

-doc_type: apiPageType

-# Create organizationalMessageDetail

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Create a new [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.

-## Prerequisites

-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)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-POST /deviceManagement/organizationalMessageDetails

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-In the request body, supply a JSON representation for the organizationalMessageDetail object.

-The following table shows the properties that are required when you create the organizationalMessageDetail.

-|Property|Type|Description|

-|:|:|:|

-|id|String|A unique identifier for the organizational message|

-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the message. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|

-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|

-|status|[organizationalMessageStatus](../resources/intune-partnerintegration-organizationalmessagestatus.md)|Indicates the deployment status of the message. Possible values are: `scheduled`, `active`, `completed`, `cancelled`, `unknownFutureValue`.|

-|startDateTime|DateTimeOffset|The date and time of when the message will start being displayed to clients|

-|endDateTime|DateTimeOffset|The date and time of when the message will stop being displayed to clients|

-|createdDateTime|DateTimeOffset|The date and time of when the message was created|

-|lastModifiedDateTime|DateTimeOffset|The date and time of when the message was last modified|

-|userEngagementStatistics|[organizationalMessageInsights](../resources/intune-partnerintegration-organizationalmessageinsights.md)|The statistics containing how the message was interacted with by clients. This includes the number of impressions, clicks, and dismisses from targeted clients.|

-|frequency|[organizationalMessageFrequency](../resources/intune-partnerintegration-organizationalmessagefrequency.md)|The frequency at which a client will see the message. Possible values are: `weeklyOnce`, `monthlyOnce`, `monthlyTwice`, `unknownFutureValue`.|

-|targeting|[organizationalMessageTargeting](../resources/intune-partnerintegration-organizationalmessagetargeting.md)|The groups of devices that will receive the message. This also contains a list of excluded groups that will not receive the message regardless of the device being part of an included group|

-|content|[organizationalMessageContent](../resources/intune-partnerintegration-organizationalmessagecontent.md)|The content that will be displayed to clients for the message. This includes the text portion of the message and the displayed logo|

-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the experience. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|

-|variant|String|Indicates the corresponding variant for the experience|

-## Response

-If successful, this method returns a `201 Created` response code and a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-POST https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails

-Content-type: application/json

-Content-length: 2049

-{

- "@odata.type": "#microsoft.graph.organizationalMessageDetail",

- "scenario": "lifecycle",

- "surface": "getStarted",

- "status": "active",

- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",

- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",

- "userEngagementStatistics": {

- "@odata.type": "microsoft.graph.organizationalMessageInsights",

- "impressions": 11,

- "clicks": 6,

- "dismisses": 9

- },

- "frequency": "monthlyOnce",

- "targeting": {

- "@odata.type": "microsoft.graph.organizationalMessageTargeting",

- "targetingType": "unknownFutureValue",

- "includeIds": [

- "Include Ids value"

- ],

- "excludeIds": [

- "Exclude Ids value"

- ]

- },

- "content": {

- "@odata.type": "microsoft.graph.organizationalMessageContent",

- "guidedContentId": "Guided Content Id value",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logoInfo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogo",

- "logo": "bG9nbw==",

- "contentType": "unknownFutureValue",

- "logoCdnUrl": "https://example.com/logoCdnUrl/"

- }

- },

- "theme": "training",

- "variant": "Variant value"

-}

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 201 Created

-Content-Type: application/json

-Content-Length: 2221

-{

- "@odata.type": "#microsoft.graph.organizationalMessageDetail",

- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",

- "scenario": "lifecycle",

- "surface": "getStarted",

- "status": "active",

- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",

- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",

- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",

- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",

- "userEngagementStatistics": {

- "@odata.type": "microsoft.graph.organizationalMessageInsights",

- "impressions": 11,

- "clicks": 6,

- "dismisses": 9

- },

- "frequency": "monthlyOnce",

- "targeting": {

- "@odata.type": "microsoft.graph.organizationalMessageTargeting",

- "targetingType": "unknownFutureValue",

- "includeIds": [

- "Include Ids value"

- ],

- "excludeIds": [

- "Exclude Ids value"

- ]

- },

- "content": {

- "@odata.type": "microsoft.graph.organizationalMessageContent",

- "guidedContentId": "Guided Content Id value",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logoInfo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogo",

- "logo": "bG9nbw==",

- "contentType": "unknownFutureValue",

- "logoCdnUrl": "https://example.com/logoCdnUrl/"

- }

- },

- "theme": "training",

- "variant": "Variant value"

-}

-```

-description: "Deletes a organizationalMessageDetail."

-localization_priority: Normal

-doc_type: apiPageType

-# Delete organizationalMessageDetail

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Deletes a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md).

-## Prerequisites

-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)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-DELETE /deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-Do not supply a request body for this method.

-## Response

-If successful, this method returns a `204 No Content` response code.

-## Example

-### Request

-Here is an example of the request.

-``` http

-DELETE https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 204 No Content

-```

-description: "Read properties and relationships of the organizationalMessageDetail object."

-localization_priority: Normal

-doc_type: apiPageType

-# Get organizationalMessageDetail

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Read properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.

-## Prerequisites

-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)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-GET /deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}

-```

-## Optional query parameters

-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-Do not supply a request body for this method.

-## Response

-If successful, this method returns a `200 OK` response code and [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 200 OK

-Content-Type: application/json

-Content-Length: 2368

-{

- "value": {

- "@odata.type": "#microsoft.graph.organizationalMessageDetail",

- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",

- "scenario": "lifecycle",

- "surface": "getStarted",

- "status": "active",

- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",

- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",

- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",

- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",

- "userEngagementStatistics": {

- "@odata.type": "microsoft.graph.organizationalMessageInsights",

- "impressions": 11,

- "clicks": 6,

- "dismisses": 9

- },

- "frequency": "monthlyOnce",

- "targeting": {

- "@odata.type": "microsoft.graph.organizationalMessageTargeting",

- "targetingType": "unknownFutureValue",

- "includeIds": [

- "Include Ids value"

- ],

- "excludeIds": [

- "Exclude Ids value"

- ]

- },

- "content": {

- "@odata.type": "microsoft.graph.organizationalMessageContent",

- "guidedContentId": "Guided Content Id value",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logoInfo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogo",

- "logo": "bG9nbw==",

- "contentType": "unknownFutureValue",

- "logoCdnUrl": "https://example.com/logoCdnUrl/"

- }

- },

- "theme": "training",

- "variant": "Variant value"

- }

-}

-```

-description: "List properties and relationships of the organizationalMessageDetail objects."

-localization_priority: Normal

-doc_type: apiPageType

-# List organizationalMessageDetails

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-List properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) objects.

-## Prerequisites

-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)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-GET /deviceManagement/organizationalMessageDetails

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## 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 [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) objects in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 200 OK

-Content-Type: application/json

-Content-Length: 2510

-{

- "value": [

- {

- "@odata.type": "#microsoft.graph.organizationalMessageDetail",

- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",

- "scenario": "lifecycle",

- "surface": "getStarted",

- "status": "active",

- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",

- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",

- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",

- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",

- "userEngagementStatistics": {

- "@odata.type": "microsoft.graph.organizationalMessageInsights",

- "impressions": 11,

- "clicks": 6,

- "dismisses": 9

- },

- "frequency": "monthlyOnce",

- "targeting": {

- "@odata.type": "microsoft.graph.organizationalMessageTargeting",

- "targetingType": "unknownFutureValue",

- "includeIds": [

- "Include Ids value"

- ],

- "excludeIds": [

- "Exclude Ids value"

- ]

- },

- "content": {

- "@odata.type": "microsoft.graph.organizationalMessageContent",

- "guidedContentId": "Guided Content Id value",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logoInfo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogo",

- "logo": "bG9nbw==",

- "contentType": "unknownFutureValue",

- "logoCdnUrl": "https://example.com/logoCdnUrl/"

- }

- },

- "theme": "training",

- "variant": "Variant value"

- }

- ]

-}

-```

-description: "Update the properties of a organizationalMessageDetail object."

-localization_priority: Normal

-doc_type: apiPageType

-# Update organizationalMessageDetail

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Update the properties of a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.

-## Prerequisites

-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)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-PATCH /deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-In the request body, supply a JSON representation for the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.

-The following table shows the properties that are required when you create the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md).

-|Property|Type|Description|

-|:|:|:|

-|id|String|A unique identifier for the organizational message|

-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the message. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|

-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|

-|status|[organizationalMessageStatus](../resources/intune-partnerintegration-organizationalmessagestatus.md)|Indicates the deployment status of the message. Possible values are: `scheduled`, `active`, `completed`, `cancelled`, `unknownFutureValue`.|

-|startDateTime|DateTimeOffset|The date and time of when the message will start being displayed to clients|

-|endDateTime|DateTimeOffset|The date and time of when the message will stop being displayed to clients|

-|createdDateTime|DateTimeOffset|The date and time of when the message was created|

-|lastModifiedDateTime|DateTimeOffset|The date and time of when the message was last modified|

-|userEngagementStatistics|[organizationalMessageInsights](../resources/intune-partnerintegration-organizationalmessageinsights.md)|The statistics containing how the message was interacted with by clients. This includes the number of impressions, clicks, and dismisses from targeted clients.|

-|frequency|[organizationalMessageFrequency](../resources/intune-partnerintegration-organizationalmessagefrequency.md)|The frequency at which a client will see the message. Possible values are: `weeklyOnce`, `monthlyOnce`, `monthlyTwice`, `unknownFutureValue`.|

-|targeting|[organizationalMessageTargeting](../resources/intune-partnerintegration-organizationalmessagetargeting.md)|The groups of devices that will receive the message. This also contains a list of excluded groups that will not receive the message regardless of the device being part of an included group|

-|content|[organizationalMessageContent](../resources/intune-partnerintegration-organizationalmessagecontent.md)|The content that will be displayed to clients for the message. This includes the text portion of the message and the displayed logo|

-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the experience. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|

-|variant|String|Indicates the corresponding variant for the experience|

-## Response

-If successful, this method returns a `200 OK` response code and an updated [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-PATCH https://graph.microsoft.com/beta/deviceManagement/organizationalMessageDetails/{organizationalMessageDetailId}

-Content-type: application/json

-Content-length: 2049

-{

- "@odata.type": "#microsoft.graph.organizationalMessageDetail",

- "scenario": "lifecycle",

- "surface": "getStarted",

- "status": "active",

- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",

- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",

- "userEngagementStatistics": {

- "@odata.type": "microsoft.graph.organizationalMessageInsights",

- "impressions": 11,

- "clicks": 6,

- "dismisses": 9

- },

- "frequency": "monthlyOnce",

- "targeting": {

- "@odata.type": "microsoft.graph.organizationalMessageTargeting",

- "targetingType": "unknownFutureValue",

- "includeIds": [

- "Include Ids value"

- ],

- "excludeIds": [

- "Exclude Ids value"

- ]

- },

- "content": {

- "@odata.type": "microsoft.graph.organizationalMessageContent",

- "guidedContentId": "Guided Content Id value",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logoInfo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogo",

- "logo": "bG9nbw==",

- "contentType": "unknownFutureValue",

- "logoCdnUrl": "https://example.com/logoCdnUrl/"

- }

- },

- "theme": "training",

- "variant": "Variant value"

-}

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 200 OK

-Content-Type: application/json

-Content-Length: 2221

-{

- "@odata.type": "#microsoft.graph.organizationalMessageDetail",

- "id": "affbf3ad-f3ad-affb-adf3-fbafadf3fbaf",

- "scenario": "lifecycle",

- "surface": "getStarted",

- "status": "active",

- "startDateTime": "2016-12-31T23:58:46.7156189-08:00",

- "endDateTime": "2017-01-01T00:03:30.9241974-08:00",

- "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",

- "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",

- "userEngagementStatistics": {

- "@odata.type": "microsoft.graph.organizationalMessageInsights",

- "impressions": 11,

- "clicks": 6,

- "dismisses": 9

- },

- "frequency": "monthlyOnce",

- "targeting": {

- "@odata.type": "microsoft.graph.organizationalMessageTargeting",

- "targetingType": "unknownFutureValue",

- "includeIds": [

- "Include Ids value"

- ],

- "excludeIds": [

- "Exclude Ids value"

- ]

- },

- "content": {

- "@odata.type": "microsoft.graph.organizationalMessageContent",

- "guidedContentId": "Guided Content Id value",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logoInfo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogo",

- "logo": "bG9nbw==",

- "contentType": "unknownFutureValue",

- "logoCdnUrl": "https://example.com/logoCdnUrl/"

- }

- },

- "theme": "training",

- "variant": "Variant value"

-}

-```

-description: "Create a new organizationalMessageGuidedContent object."

-localization_priority: Normal

-doc_type: apiPageType

-# Create organizationalMessageGuidedContent

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Create a new [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.

-## Prerequisites

-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)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-POST /deviceManagement/organizationalMessageGuidedContents

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-In the request body, supply a JSON representation for the organizationalMessageGuidedContent object.

-The following table shows the properties that are required when you create the organizationalMessageGuidedContent.

-|Property|Type|Description|

-|:|:|:|

-|id|String|A unique identifier for the guided content|

-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the guided content. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|

-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the guided content. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|

-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|

-|placementDetails|[organizationalMessagePlacementDetail](../resources/intune-partnerintegration-organizationalmessageplacementdetail.md) collection|Contains the different types of text content that can be displayed to customers along with their localized values|

-|logo|[organizationalMessageLogoGuide](../resources/intune-partnerintegration-organizationalmessagelogoguide.md)|Example of the logo that will be displayed to customers and its size requirements|

-## Response

-If successful, this method returns a `201 Created` response code and a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-POST https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents

-Content-type: application/json

-Content-length: 1403

-{

- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",

- "scenario": "lifecycle",

- "theme": "training",

- "surface": "getStarted",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",

- "logoCdnUrl": "https://example.com/logoCdnUrl/",

- "assetName": "Asset Name value",

- "dimensions": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",

- "minWidth": 8,

- "maxWidth": 8,

- "minHeight": 9,

- "maxHeight": 9

- }

- }

-}

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 201 Created

-Content-Type: application/json

-Content-Length: 1452

-{

- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",

- "id": "13e64843-4843-13e6-4348-e6134348e613",

- "scenario": "lifecycle",

- "theme": "training",

- "surface": "getStarted",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",

- "logoCdnUrl": "https://example.com/logoCdnUrl/",

- "assetName": "Asset Name value",

- "dimensions": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",

- "minWidth": 8,

- "maxWidth": 8,

- "minHeight": 9,

- "maxHeight": 9

- }

- }

-}

-```

-description: "Deletes a organizationalMessageGuidedContent."

-localization_priority: Normal

-doc_type: apiPageType

-# Delete organizationalMessageGuidedContent

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Deletes a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md).

-## Prerequisites

-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)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-DELETE /deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-Do not supply a request body for this method.

-## Response

-If successful, this method returns a `204 No Content` response code.

-## Example

-### Request

-Here is an example of the request.

-``` http

-DELETE https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 204 No Content

-```

-description: "Read properties and relationships of the organizationalMessageGuidedContent object."

-localization_priority: Normal

-doc_type: apiPageType

-# Get organizationalMessageGuidedContent

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Read properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.

-## Prerequisites

-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)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-GET /deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}

-```

-## Optional query parameters

-This method supports the [OData Query Parameters](/graph/query-parameters) to help customize the response.

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-Do not supply a request body for this method.

-## Response

-If successful, this method returns a `200 OK` response code and [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 200 OK

-Content-Type: application/json

-Content-Length: 1557

-{

- "value": {

- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",

- "id": "13e64843-4843-13e6-4348-e6134348e613",

- "scenario": "lifecycle",

- "theme": "training",

- "surface": "getStarted",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",

- "logoCdnUrl": "https://example.com/logoCdnUrl/",

- "assetName": "Asset Name value",

- "dimensions": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",

- "minWidth": 8,

- "maxWidth": 8,

- "minHeight": 9,

- "maxHeight": 9

- }

- }

- }

-}

-```

-description: "List properties and relationships of the organizationalMessageGuidedContent objects."

-localization_priority: Normal

-doc_type: apiPageType

-# List organizationalMessageGuidedContents

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-List properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) objects.

-## Prerequisites

-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)|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.Read.All, DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.Read.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-GET /deviceManagement/organizationalMessageGuidedContents

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## 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 [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) objects in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-GET https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 200 OK

-Content-Type: application/json

-Content-Length: 1657

-{

- "value": [

- {

- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",

- "id": "13e64843-4843-13e6-4348-e6134348e613",

- "scenario": "lifecycle",

- "theme": "training",

- "surface": "getStarted",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",

- "logoCdnUrl": "https://example.com/logoCdnUrl/",

- "assetName": "Asset Name value",

- "dimensions": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",

- "minWidth": 8,

- "maxWidth": 8,

- "minHeight": 9,

- "maxHeight": 9

- }

- }

- }

- ]

-}

-```

-description: "Update the properties of a organizationalMessageGuidedContent object."

-localization_priority: Normal

-doc_type: apiPageType

-# Update organizationalMessageGuidedContent

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Update the properties of a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.

-## Prerequisites

-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)|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-|Delegated (personal Microsoft account)|Not supported.|

-|Application|DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All|

-## HTTP Request

-<!-- {

- "blockType": "ignored"

-}

-``` http

-PATCH /deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}

-```

-## Request headers

-|Header|Value|

-|:|:|

-|Authorization|Bearer &lt;token&gt; Required.|

-|Accept|application/json|

-## Request body

-In the request body, supply a JSON representation for the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.

-The following table shows the properties that are required when you create the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md).

-|Property|Type|Description|

-|:|:|:|

-|id|String|A unique identifier for the guided content|

-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the guided content. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|

-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the guided content. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|

-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|

-|placementDetails|[organizationalMessagePlacementDetail](../resources/intune-partnerintegration-organizationalmessageplacementdetail.md) collection|Contains the different types of text content that can be displayed to customers along with their localized values|

-|logo|[organizationalMessageLogoGuide](../resources/intune-partnerintegration-organizationalmessagelogoguide.md)|Example of the logo that will be displayed to customers and its size requirements|

-## Response

-If successful, this method returns a `200 OK` response code and an updated [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object in the response body.

-## Example

-### Request

-Here is an example of the request.

-``` http

-PATCH https://graph.microsoft.com/beta/deviceManagement/organizationalMessageGuidedContents/{organizationalMessageGuidedContentId}

-Content-type: application/json

-Content-length: 1403

-{

- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",

- "scenario": "lifecycle",

- "theme": "training",

- "surface": "getStarted",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",

- "logoCdnUrl": "https://example.com/logoCdnUrl/",

- "assetName": "Asset Name value",

- "dimensions": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",

- "minWidth": 8,

- "maxWidth": 8,

- "minHeight": 9,

- "maxHeight": 9

- }

- }

-}

-```

-### Response

-Here is an example of the response. Note: The response object shown here may be truncated for brevity. All of the properties will be returned from an actual call.

-``` http

-HTTP/1.1 200 OK

-Content-Type: application/json

-Content-Length: 1452

-{

- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",

- "id": "13e64843-4843-13e6-4348-e6134348e613",

- "scenario": "lifecycle",

- "theme": "training",

- "surface": "getStarted",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "card0",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "Variant Id value",

- "name": "Name value",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "Locale value",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "Title value",

- "message": "Message value",

- "clickUrl": "https://example.com/clickUrl/",

- "buttonText": "Button Text value"

- }

- }

- ]

- }

- ]

- }

- ],

- "logo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",

- "logoCdnUrl": "https://example.com/logoCdnUrl/",

- "assetName": "Asset Name value",

- "dimensions": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",

- "minWidth": 8,

- "maxWidth": 8,

- "minHeight": 9,

- "maxHeight": 9

- }

- }

-}

-```

-description: "Contains the entire content of the message that will be displayed to the clients"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageContent resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Contains the entire content of the message that will be displayed to the clients

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|guidedContentId|String|The ID of the guided content that this content is using|

-|placementDetails|[organizationalMessagePlacementDetail](../resources/intune-partnerintegration-organizationalmessageplacementdetail.md) collection|Contains the different types of text content that can be displayed to customers along with their localized values|

-|logoInfo|[organizationalMessageLogo](../resources/intune-partnerintegration-organizationalmessagelogo.md)|The logo that will be displayed to the clients. This will contain ether the binary contents of the logo or a url to the logo's location|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessageContent"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageContent",

- "guidedContentId": "String",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "String",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "String",

- "name": "String",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "String",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "String",

- "message": "String",

- "clickUrl": "String",

- "buttonText": "String"

- }

- }

- ]

- }

- ]

- }

- ],

- "logoInfo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogo",

- "logo": "binary",

- "contentType": "String",

- "logoCdnUrl": "String"

- }

-}

-```

-description: "This will allow the admin to see the specific details of an organizational message that has been created for their tenant"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageDetail resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-This will allow the admin to see the specific details of an organizational message that has been created for their tenant

-## Methods

-|Method|Return Type|Description|

-|:|:|:|

-|[List organizationalMessageDetails](../api/intune-partnerintegration-organizationalmessagedetail-list.md)|[organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) collection|List properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) objects.|

-|[Get organizationalMessageDetail](../api/intune-partnerintegration-organizationalmessagedetail-get.md)|[organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md)|Read properties and relationships of the [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.|

-|[Create organizationalMessageDetail](../api/intune-partnerintegration-organizationalmessagedetail-create.md)|[organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md)|Create a new [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.|

-|[Delete organizationalMessageDetail](../api/intune-partnerintegration-organizationalmessagedetail-delete.md)|None|Deletes a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md).|

-|[Update organizationalMessageDetail](../api/intune-partnerintegration-organizationalmessagedetail-update.md)|[organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md)|Update the properties of a [organizationalMessageDetail](../resources/intune-partnerintegration-organizationalmessagedetail.md) object.|

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|id|String|A unique identifier for the organizational message|

-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the message. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|

-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|

-|status|[organizationalMessageStatus](../resources/intune-partnerintegration-organizationalmessagestatus.md)|Indicates the deployment status of the message. Possible values are: `scheduled`, `active`, `completed`, `cancelled`, `unknownFutureValue`.|

-|startDateTime|DateTimeOffset|The date and time of when the message will start being displayed to clients|

-|endDateTime|DateTimeOffset|The date and time of when the message will stop being displayed to clients|

-|createdDateTime|DateTimeOffset|The date and time of when the message was created|

-|lastModifiedDateTime|DateTimeOffset|The date and time of when the message was last modified|

-|userEngagementStatistics|[organizationalMessageInsights](../resources/intune-partnerintegration-organizationalmessageinsights.md)|The statistics containing how the message was interacted with by clients. This includes the number of impressions, clicks, and dismisses from targeted clients.|

-|frequency|[organizationalMessageFrequency](../resources/intune-partnerintegration-organizationalmessagefrequency.md)|The frequency at which a client will see the message. Possible values are: `weeklyOnce`, `monthlyOnce`, `monthlyTwice`, `unknownFutureValue`.|

-|targeting|[organizationalMessageTargeting](../resources/intune-partnerintegration-organizationalmessagetargeting.md)|The groups of devices that will receive the message. This also contains a list of excluded groups that will not receive the message regardless of the device being part of an included group|

-|content|[organizationalMessageContent](../resources/intune-partnerintegration-organizationalmessagecontent.md)|The content that will be displayed to clients for the message. This includes the text portion of the message and the displayed logo|

-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the experience. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|

-|variant|String|Indicates the corresponding variant for the experience|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "keyProperty": "id",

- "@odata.type": "microsoft.graph.organizationalMessageDetail"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageDetail",

- "id": "String (identifier)",

- "scenario": "String",

- "surface": "String",

- "status": "String",

- "startDateTime": "String (timestamp)",

- "endDateTime": "String (timestamp)",

- "createdDateTime": "String (timestamp)",

- "lastModifiedDateTime": "String (timestamp)",

- "userEngagementStatistics": {

- "@odata.type": "microsoft.graph.organizationalMessageInsights",

- "impressions": 1024,

- "clicks": 1024,

- "dismisses": 1024

- },

- "frequency": "String",

- "targeting": {

- "@odata.type": "microsoft.graph.organizationalMessageTargeting",

- "targetingType": "String",

- "includeIds": [

- "String"

- ],

- "excludeIds": [

- "String"

- ]

- },

- "content": {

- "@odata.type": "microsoft.graph.organizationalMessageContent",

- "guidedContentId": "String",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "String",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "String",

- "name": "String",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "String",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "String",

- "message": "String",

- "clickUrl": "String",

- "buttonText": "String"

- }

- }

- ]

- }

- ]

- }

- ],

- "logoInfo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogo",

- "logo": "binary",

- "contentType": "String",

- "logoCdnUrl": "String"

- }

- },

- "theme": "String",

- "variant": "String"

-}

-```

-description: "Indicates the frequency at which a client will see the message"

-localization_priority: Normal

-doc_type: enumPageType

-# organizationalMessageFrequency enum type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Indicates the frequency at which a client will see the message

-## Members

-|Member|Value|Description|

-|:|:|:|

-|weeklyOnce|0|Indicates that the message will be displayed once a week|

-|monthlyOnce|1|Indicates that the message will be displayed once a month|

-|monthlyTwice|2|Indicates that the message will be displayed twice a month|

-|unknownFutureValue|3|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|

-description: "This will allow the admin to see the different templated organizational messages that can be created"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageGuidedContent resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-This will allow the admin to see the different templated organizational messages that can be created

-## Methods

-|Method|Return Type|Description|

-|:|:|:|

-|[List organizationalMessageGuidedContents](../api/intune-partnerintegration-organizationalmessageguidedcontent-list.md)|[organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) collection|List properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) objects.|

-|[Get organizationalMessageGuidedContent](../api/intune-partnerintegration-organizationalmessageguidedcontent-get.md)|[organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md)|Read properties and relationships of the [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.|

-|[Create organizationalMessageGuidedContent](../api/intune-partnerintegration-organizationalmessageguidedcontent-create.md)|[organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md)|Create a new [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.|

-|[Delete organizationalMessageGuidedContent](../api/intune-partnerintegration-organizationalmessageguidedcontent-delete.md)|None|Deletes a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md).|

-|[Update organizationalMessageGuidedContent](../api/intune-partnerintegration-organizationalmessageguidedcontent-update.md)|[organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md)|Update the properties of a [organizationalMessageGuidedContent](../resources/intune-partnerintegration-organizationalmessageguidedcontent.md) object.|

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|id|String|A unique identifier for the guided content|

-|scenario|[organizationalMessageScenario](../resources/intune-partnerintegration-organizationalmessagescenario.md)|Indicates the scenario for the guided content. Possible values are: `onboarding`, `lifecycle`, `unknownFutureValue`.|

-|theme|[organizationalMessageTheme](../resources/intune-partnerintegration-organizationalmessagetheme.md)|Indicates the theme for the guided content. Possible values are: `update`, `training`, `welcomeToWindows`, `explore`, `unknownFutureValue`.|

-|surface|[organizationalMessageSurface](../resources/intune-partnerintegration-organizationalmessagesurface.md)|Indicates the area where content will be displayed to customers. Possible values are: `actionCenter`, `getStarted`, `softLanding`, `unknownFutureValue`.|

-|placementDetails|[organizationalMessagePlacementDetail](../resources/intune-partnerintegration-organizationalmessageplacementdetail.md) collection|Contains the different types of text content that can be displayed to customers along with their localized values|

-|logo|[organizationalMessageLogoGuide](../resources/intune-partnerintegration-organizationalmessagelogoguide.md)|Example of the logo that will be displayed to customers and its size requirements|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "keyProperty": "id",

- "@odata.type": "microsoft.graph.organizationalMessageGuidedContent"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageGuidedContent",

- "id": "String (identifier)",

- "scenario": "String",

- "theme": "String",

- "surface": "String",

- "placementDetails": [

- {

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "String",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "String",

- "name": "String",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "String",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "String",

- "message": "String",

- "clickUrl": "String",

- "buttonText": "String"

- }

- }

- ]

- }

- ]

- }

- ],

- "logo": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide",

- "logoCdnUrl": "String",

- "assetName": "String",

- "dimensions": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",

- "minWidth": 1024,

- "maxWidth": 1024,

- "minHeight": 1024,

- "maxHeight": 1024

- }

- }

-}

-```

-description: "Contains statistics into how the organizational message was interacted with by clients"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageInsights resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Contains statistics into how the organizational message was interacted with by clients

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|impressions|Int32|The number of times this message was shown to all clients|

-|clicks|Int32|The number of times this message was clicked on|

-|dismisses|Int32|The number of times this message was dismissed by a user. This may not be collected for some surfaces and will be null|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessageInsights"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageInsights",

- "impressions": 1024,

- "clicks": 1024,

- "dismisses": 1024

-}

-```

-description: "Contains the text to be displayed for a given locale"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageLocalizedText resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Contains the text to be displayed for a given locale

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|locale|String|The locale for this text|

-|text|[organizationalMessageText](../resources/intune-partnerintegration-organizationalmessagetext.md)|The text that will be displayed to a user from this specific locale|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageLocalizedText",

- "locale": "String",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "String",

- "message": "String",

- "clickUrl": "String",

- "buttonText": "String"

- }

-}

-```

-description: "Contains the logo's binary content or a url to the logo's downloadable location. Either both logo and contentType contain valid values or logoCdnUrl contains a valid url"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageLogo resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Contains the logo's binary content or a url to the logo's downloadable location. Either both logo and contentType contain valid values or logoCdnUrl contains a valid url

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|logo|Binary|The binary contents of the logo. This is null when logoCdnUrl is used to send the logo|

-|contentType|[organizationalMessageLogoType](../resources/intune-partnerintegration-organizationalmessagelogotype.md)|The content type of the logo that is contained in the logo array. This is null when logoCdnUrl is used to send the logo. Possible values are: `png`, `unknownFutureValue`.|

-|logoCdnUrl|String|The url at which the logo resides. This is null when logo and contentType are used to send the logo|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessageLogo"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageLogo",

- "logo": "binary",

- "contentType": "String",

- "logoCdnUrl": "String"

-}

-```

-description: "Contains the required size dimensions of a logo"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageLogoDimensions resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Contains the required size dimensions of a logo

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|minWidth|Int32|Minimum width of the logo|

-|maxWidth|Int32|Maximum width of the logo|

-|minHeight|Int32|Minimum height of the logo|

-|maxHeight|Int32|Maximum height of the logo|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageLogoDimensions",

- "minWidth": 1024,

- "maxWidth": 1024,

- "minHeight": 1024,

- "maxHeight": 1024

-}

-```

-description: "Example logo and its size requirements"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageLogoGuide resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Example logo and its size requirements

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|logoCdnUrl|String|The url at which the logo resides|

-|assetName|String|The asset name is the key for this specific logo. This is used to compute the required token when accessing the logoCdnUrl to fetch the logo|

-|dimensions|[organizationalMessageLogoDimensions](../resources/intune-partnerintegration-organizationalmessagelogodimensions.md)|The required size dimensions of the logo|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessageLogoGuide"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageLogoGuide",

- "logoCdnUrl": "String",

- "assetName": "String",

- "dimensions": {

- "@odata.type": "microsoft.graph.organizationalMessageLogoDimensions",

- "minWidth": 1024,

- "maxWidth": 1024,

- "minHeight": 1024,

- "maxHeight": 1024

- }

-}

-```

-description: "Indicates the content type of the logo"

-localization_priority: Normal

-doc_type: enumPageType

-# organizationalMessageLogoType enum type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Indicates the content type of the logo

-## Members

-|Member|Value|Description|

-|:|:|:|

-|png|0|Indicates that logo is a png file|

-|unknownFutureValue|1|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|

-description: "Indicates the name of the placement"

-localization_priority: Normal

-doc_type: enumPageType

-# organizationalMessagePlacement enum type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Indicates the name of the placement

-## Members

-|Member|Value|Description|

-|:|:|:|

-|default|0|Indicates the default area for text to be displayed. This is the only valid placement value for the actionCenter and softLanding surfaces|

-|card0|1|Indicates the area where the first card is displayed. Only applies to the getStarted surface|

-|card1|2|Indicates the area where the second card is displayed. Only applies to the getStarted surface|

-|card2|3|Indicates the area where the third card is displayed. Only applies to the getStarted surface|

-|card3|4|Indicates the area where the fourth card is displayed. Only applies to the getStarted surface|

-|unknownFutureValue|5|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|

-description: "Contains the different variants of text that can be displayed for a given placement within a surface"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessagePlacementDetail resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Contains the different variants of text that can be displayed for a given placement within a surface

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|placement|[organizationalMessagePlacement](../resources/intune-partnerintegration-organizationalmessageplacement.md)|Indicates the name of the placement. Possible values are: `default`, `card0`, `card1`, `card2`, `card3`, `unknownFutureValue`.|

-|variants|[organizationalMessageVariant](../resources/intune-partnerintegration-organizationalmessagevariant.md) collection|The list of different variants that can be displayed for this placement|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessagePlacementDetail"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessagePlacementDetail",

- "placement": "String",

- "variants": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageVariant",

- "variantId": "String",

- "name": "String",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "String",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "String",

- "message": "String",

- "clickUrl": "String",

- "buttonText": "String"

- }

- }

- ]

- }

- ]

-}

-```

-description: "Indicates the scenario for the message"

-localization_priority: Normal

-doc_type: enumPageType

-# organizationalMessageScenario enum type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Indicates the scenario for the message

-## Members

-|Member|Value|Description|

-|:|:|:|

-|onboarding|0|Indicates onboarding scenario|

-|lifecycle|1|Indicates lifecycle scenario|

-|unknownFutureValue|2|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|

-description: "Indicates the deployment status of the message"

-localization_priority: Normal

-doc_type: enumPageType

-# organizationalMessageStatus enum type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Indicates the deployment status of the message

-## Members

-|Member|Value|Description|

-|:|:|:|

-|scheduled|0|Indicates that the message has been scheduled for a future date|

-|active|1|Indicates that the message is currently live and being presented to clients|

-|completed|2|Indicates that the message has been displayed to users already and is no longer active|

-|cancelled|3|Indicates that the message has been cancelled and will not be shown|

-|unknownFutureValue|4|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|

-description: "Indicates the area where content will be displayed to customers"

-localization_priority: Normal

-doc_type: enumPageType

-# organizationalMessageSurface enum type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Indicates the area where content will be displayed to customers

-## Members

-|Member|Value|Description|

-|:|:|:|

-|actionCenter|0|Indicates the message will be displayed on the Window's Action Center|

-|getStarted|1|Indicates the message will be displayed on the Get Started page|

-|softLanding|2|Indicates the message will be displayed to the Soft Landing which is anchored to the Windows taskbar|

-|unknownFutureValue|3|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|

-description: "Contains the groups of devices that will be targeted to receive the organizational message. If a device is part of the excluded group, then it will not receive the message, regardless of the device being part of an included group"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageTargeting resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Contains the groups of devices that will be targeted to receive the organizational message. If a device is part of the excluded group, then it will not receive the message, regardless of the device being part of an included group

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|targetingType|[organizationalMessageTargetingType](../resources/intune-partnerintegration-organizationalmessagetargetingtype.md)|Indicates the type of targeting. Possible values are: `aadGroup`, `unknownFutureValue`.|

-|includeIds|String collection|The groups that will be targeted and receive the message|

-|excludeIds|String collection|The groups that will not receive the message. If a user from an excluded group is part of an included group, it will not receive the message|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessageTargeting"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageTargeting",

- "targetingType": "String",

- "includeIds": [

- "String"

- ],

- "excludeIds": [

- "String"

- ]

-}

-```

-description: "Indicates the type of targeting"

-localization_priority: Normal

-doc_type: enumPageType

-# organizationalMessageTargetingType enum type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Indicates the type of targeting

-## Members

-|Member|Value|Description|

-|:|:|:|

-|aadGroup|0|Indicates that client devices are targeted by their AAD group|

-|unknownFutureValue|1|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|

-description: "This will allow the admin to see tenant consent info for specific tenant"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageTenantConsent resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-This will allow the admin to see tenant consent info for specific tenant

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|firstPartyMessageAllowed|Boolean|Indicates if first party message is allowed|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessageTenantConsent"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageTenantConsent",

- "firstPartyMessageAllowed": true

-}

-```

-description: "Contains the text that will be displayed to users for a particular variant"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageText resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Contains the text that will be displayed to users for a particular variant

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|title|String|Indicates the title that will be displayed|

-|message|String|Indicates the message that will be displayed|

-|clickUrl|String|Indicates the url that the user will be directed to when the message is clicked|

-|buttonText|String|Indicates the text that will be displayed on the button of the message. This field applies to the softLanding surface|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessageText"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageText",

- "title": "String",

- "message": "String",

- "clickUrl": "String",

- "buttonText": "String"

-}

-```

-description: "Indicates the theme for the guided content"

-localization_priority: Normal

-doc_type: enumPageType

-# organizationalMessageTheme enum type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Indicates the theme for the guided content

-## Members

-|Member|Value|Description|

-|:|:|:|

-|update|0|Indicates the Update theme|

-|training|1|Indicates the Training theme|

-|welcomeToWindows|2|Indicates the Welcome to Windows theme|

-|explore|3|Indicates the Explore|

-|unknownFutureValue|4|UnknownFutureValue, Evolvable enumeration sentinel value. Do not use.|

-description: "Contains the localized text to be displayed for a given variant"

-localization_priority: Normal

-doc_type: resourcePageType

-# organizationalMessageVariant resource type

-Namespace: microsoft.graph

-> **Important:** Microsoft Graph APIs under the /beta version are subject to change; production use is not supported.

-> **Note:** The Microsoft Graph API for Intune requires an [active Intune license](https://go.microsoft.com/fwlink/?linkid=839381) for the tenant.

-Contains the localized text to be displayed for a given variant

-## Properties

-|Property|Type|Description|

-|:|:|:|

-|variantId|String|A unique identifier for this variant|

-|name|String|The name of the variant|

-|localizedTexts|[organizationalMessageLocalizedText](../resources/intune-partnerintegration-organizationalmessagelocalizedtext.md) collection|The list of localized texts for this variant|

-## Relationships

-None

-## JSON Representation

-Here is a JSON representation of the resource.

-<!-- {

- "blockType": "resource",

- "@odata.type": "microsoft.graph.organizationalMessageVariant"

-}

-``` json

-{

- "@odata.type": "#microsoft.graph.organizationalMessageVariant",

- "variantId": "String",

- "name": "String",

- "localizedTexts": [

- {

- "@odata.type": "microsoft.graph.organizationalMessageLocalizedText",

- "locale": "String",

- "text": {

- "@odata.type": "microsoft.graph.organizationalMessageText",

- "title": "String",

- "message": "String",

- "clickUrl": "String",

- "buttonText": "String"

- }

- }

- ]

-}

-```