ServiceMessageViewpoint.Write

Allows the app to update service announcement messages' user status on behalf of the signed-in user. The message status can be marked as read, archive, or favorite.

Merill's Note

For an app to access data in Microsoft Graph, the user or administrator must grant it the permissions it needs. This article lists all the Microsoft Graph APIs and your tenant data that can be accessed by the application (vendor/developer) if you consent to the ServiceMessageViewpoint.Write permission.

If you need to create an audit report of the permissions granted to all the apps in your tenant, you can run the Export-MsIdAppConsentGrantReport command. See How To: Run a quick OAuth app audit of your tenant

Category	Application	Delegated
Identifier	-	636e1b0b-1cc2-4b1c-9aa9-4eeed9b9761b
DisplayText	-	Update user status on service announcement messages
Description	-	Allows the app to update service announcement messages' user status on behalf of the signed-in user. The message status can be marked as read, archive, or favorite.
AdminConsentRequired	Yes	Yes

Graph Methods

• API [v1.0]
• API [beta]
• PowerShell [v1.0]
• PowerShell [beta]

→ API supports delegated access (access on behalf of a user)
→ API supports app-only access (access without a user)

	Methods
	POST /admin/serviceAnnouncement/messages/archive
	POST /admin/serviceAnnouncement/messages/favorite
	POST /admin/serviceAnnouncement/messages/markRead
	POST /admin/serviceAnnouncement/messages/markUnread
	POST /admin/serviceAnnouncement/messages/unarchive
	POST /admin/serviceAnnouncement/messages/unfavorite

Resources

Granting this permission allows the calling application to access (and/or update) the following information in your tenant.

• serviceUpdateMessage

Graph reference: serviceUpdateMessage

Property	Type	Description
actionRequiredByDateTime	DateTimeOffset	The expected deadline of the action for the message.
attachmentsArchive	Stream	The zip file that contains all attachments for a message.
body	itemBody	The content type and content of the service message body. The supported value for the contentType property is html.
category	serviceUpdateCategory	The service message category. Possible values are: preventOrFixIssue, planForChange, stayInformed, unknownFutureValue.
details	Collection(keyValuePair)	Additional details about service message. This property doesn't support filters. Inherited from serviceAnnouncementBase.
endDateTime	DateTimeOffset	The end time of the service message. Inherited from serviceAnnouncementBase.
hasAttachments	Boolean	Indicates whether the message has any attachment.
id	String	The id of the service message. Inherited from serviceAnnouncementBase.
isMajorChange	Boolean	Indicates whether the message describes a major update for the service.
lastModifiedDateTime	DateTimeOffset	The last modified time of the service message. Inherited from serviceAnnouncementBase.
services	Collection(string)	The affected services by the service message.
severity	serviceUpdateSeverity	The severity of the service message. Possible values are: normal, high, critical, unknownFutureValue.
startDateTime	DateTimeOffset	The start time of the service message. Inherited from serviceAnnouncementBase.
tags	Collection(string)	A collection of tags for the service message. Tags are provided by the service team/support team who post the message to tell whether this message contains privacy data, or whether this message is for a service new feature update, and so on.
title	String	The title of the service message. Inherited from serviceAnnouncementBase.
viewPoint	serviceUpdateMessageViewpoint	Represents user viewpoints data of the service message. This data includes message status such as whether the user has archived, read, or marked the message as favorite. This property is null when accessed with application permissions.