How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Microsoft Graph admin.serviceAnnouncement API

The admin.serviceAnnouncement API from Microsoft Graph — 26 operation(s) for admin.serviceannouncement.

Microsoft Graph admin.serviceAnnouncement API is one of 564 APIs that Microsoft Graph publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 47 operations across 26 paths, and defines 28 schemas. It is described by OpenAPI 3.2.0, at version 1.0.0.

Requests are made against a single base URL, https://graph.microsoft.com/v1.0.

47 operations 26 paths 28 schemas 8 DELETE20 GET6 PATCH11 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0.0
Base URL
https://graph.microsoft.com/v1.0
Resource Areas
1

Paths & Operations 47

Across 26 paths, the API surfaces 47 operations — 8 DELETE, 20 GET, 6 PATCH, 11 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

admin.serviceAnnouncement 47
GET
/admin/serviceAnnouncement/messages
Microsoft Graph List serviceAnnouncement messages
admin.serviceAnnouncement.ListMessages 8 params → 2XX4XX5XX
POST
/admin/serviceAnnouncement/messages
Microsoft Graph Create new navigation property to messages for admin
admin.serviceAnnouncement.CreateMessages body → 2XX4XX5XX
GET
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}
Microsoft Graph Get serviceUpdateMessage
admin.serviceAnnouncement.GetMessages 3 params → 2XX4XX5XX
PATCH
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}
Microsoft Graph Update the navigation property messages in admin
admin.serviceAnnouncement.UpdateMessages 1 param body → 2XX4XX5XX
DELETE
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}
Microsoft Graph Delete navigation property messages for admin
admin.serviceAnnouncement.DeleteMessages 2 params → 2044XX5XX
GET
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments
Microsoft Graph List attachments
admin.serviceAnnouncement.messages.ListAttachments 9 params → 2XX4XX5XX
POST
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments
Microsoft Graph Create new navigation property to attachments for admin
admin.serviceAnnouncement.messages.CreateAttachments 1 param body → 2XX4XX5XX
GET
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments/{serviceAnnouncementAttachment-id}
Microsoft Graph Get serviceAnnouncementAttachment
admin.serviceAnnouncement.messages.GetAttachments 4 params → 2XX4XX5XX
PATCH
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments/{serviceAnnouncementAttachment-id}
Microsoft Graph Update the navigation property attachments in admin
admin.serviceAnnouncement.messages.UpdateAttachments 2 params body → 2XX4XX5XX
DELETE
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments/{serviceAnnouncementAttachment-id}
Microsoft Graph Delete navigation property attachments for admin
admin.serviceAnnouncement.messages.DeleteAttachments 3 params → 2044XX5XX
GET
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments/{serviceAnnouncementAttachment-id}/content
Microsoft Graph Get serviceAnnouncementAttachment
admin.serviceAnnouncement.messages.GetAttachmentsContent 2 params → 2XX4XX5XX
PUT
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments/{serviceAnnouncementAttachment-id}/content
Microsoft Graph Update content for the navigation property attachments in admin
admin.serviceAnnouncement.messages.UpdateAttachmentsContent 2 params body → 2XX4XX5XX
DELETE
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments/{serviceAnnouncementAttachment-id}/content
Microsoft Graph Delete content for the navigation property attachments in admin
admin.serviceAnnouncement.messages.DeleteAttachmentsContent 3 params → 2044XX5XX
GET
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments/$count
Microsoft Graph Get the number of the resource
admin.serviceAnnouncement.messages.attachments.GetCount-e0ef 3 params → 2XX4XX5XX
GET
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachmentsArchive
Microsoft Graph List attachments
admin.serviceAnnouncement.GetMessagesAttachmentsArchive 1 param → 2XX4XX5XX
PUT
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachmentsArchive
Microsoft Graph Update attachmentsArchive for the navigation property messages in admin
admin.serviceAnnouncement.UpdateMessagesAttachmentsArchive 1 param body → 2XX4XX5XX
DELETE
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachmentsArchive
Microsoft Graph Delete attachmentsArchive for the navigation property messages in admin
admin.serviceAnnouncement.DeleteMessagesAttachmentsArchive 2 params → 2044XX5XX
GET
/admin/serviceAnnouncement/messages/$count
Microsoft Graph Get the number of the resource
admin.serviceAnnouncement.messages.GetCount-0cc9 2 params → 2XX4XX5XX
POST
/admin/serviceAnnouncement/messages/archive
Microsoft Graph Invoke action archive
admin.serviceAnnouncement.messages.archive body → 2XX4XX5XX
POST
/admin/serviceAnnouncement/messages/favorite
Microsoft Graph Invoke action favorite
admin.serviceAnnouncement.messages.favorite body → 2XX4XX5XX
POST
/admin/serviceAnnouncement/messages/markRead
Microsoft Graph Invoke action markRead
admin.serviceAnnouncement.messages.markRead body → 2XX4XX5XX
POST
/admin/serviceAnnouncement/messages/markUnread
Microsoft Graph Invoke action markUnread
admin.serviceAnnouncement.messages.markUnread body → 2XX4XX5XX
POST
/admin/serviceAnnouncement/messages/unarchive
Microsoft Graph Invoke action unarchive
admin.serviceAnnouncement.messages.unarchive body → 2XX4XX5XX
POST
/admin/serviceAnnouncement/messages/unfavorite
Microsoft Graph Invoke action unfavorite
admin.serviceAnnouncement.messages.unfavorite body → 2XX4XX5XX
GET
/admin/serviceAnnouncement
Microsoft Graph Get serviceAnnouncement from admin
admin.GetServiceAnnouncement 2 params → 2XX4XX5XX
PATCH
/admin/serviceAnnouncement
Microsoft Graph Update the navigation property serviceAnnouncement in admin
admin.UpdateServiceAnnouncement body → 2XX4XX5XX
DELETE
/admin/serviceAnnouncement
Microsoft Graph Delete navigation property serviceAnnouncement for admin
admin.DeleteServiceAnnouncement 1 param → 2044XX5XX
GET
/admin/serviceAnnouncement/healthOverviews
Microsoft Graph List healthOverviews
admin.serviceAnnouncement.ListHealthOverviews 8 params → 2XX4XX5XX
POST
/admin/serviceAnnouncement/healthOverviews
Microsoft Graph Create new navigation property to healthOverviews for admin
admin.serviceAnnouncement.CreateHealthOverviews body → 2XX4XX5XX
GET
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}
Microsoft Graph Get serviceHealth
admin.serviceAnnouncement.GetHealthOverviews 3 params → 2XX4XX5XX
PATCH
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}
Microsoft Graph Update the navigation property healthOverviews in admin
admin.serviceAnnouncement.UpdateHealthOverviews 1 param body → 2XX4XX5XX
DELETE
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}
Microsoft Graph Delete navigation property healthOverviews for admin
admin.serviceAnnouncement.DeleteHealthOverviews 2 params → 2044XX5XX
GET
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issues
Microsoft Graph Get issues from admin
admin.serviceAnnouncement.healthOverviews.ListIssues 9 params → 2XX4XX5XX
POST
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issues
Microsoft Graph Create new navigation property to issues for admin
admin.serviceAnnouncement.healthOverviews.CreateIssues 1 param body → 2XX4XX5XX
GET
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issues/{serviceHealthIssue-id}
Microsoft Graph Get issues from admin
admin.serviceAnnouncement.healthOverviews.GetIssues 4 params → 2XX4XX5XX
PATCH
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issues/{serviceHealthIssue-id}
Microsoft Graph Update the navigation property issues in admin
admin.serviceAnnouncement.healthOverviews.UpdateIssues 2 params body → 2XX4XX5XX
DELETE
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issues/{serviceHealthIssue-id}
Microsoft Graph Delete navigation property issues for admin
admin.serviceAnnouncement.healthOverviews.DeleteIssues 3 params → 2044XX5XX
GET
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issues/{serviceHealthIssue-id}/incidentReport()
Microsoft Graph Invoke function incidentReport
admin.serviceAnnouncement.healthOverviews.serviceHealth.issues.serviceHealthIssue.incidentReport 2 params → 2XX4XX5XX
GET
/admin/serviceAnnouncement/healthOverviews/{serviceHealth-id}/issues/$count
Microsoft Graph Get the number of the resource
admin.serviceAnnouncement.healthOverviews.issues.GetCount-fd80 3 params → 2XX4XX5XX
GET
/admin/serviceAnnouncement/healthOverviews/$count
Microsoft Graph Get the number of the resource
admin.serviceAnnouncement.healthOverviews.GetCount-51c2 2 params → 2XX4XX5XX
GET
/admin/serviceAnnouncement/issues
Microsoft Graph List issues
admin.serviceAnnouncement.ListIssues 8 params → 2XX4XX5XX
POST
/admin/serviceAnnouncement/issues
Microsoft Graph Create new navigation property to issues for admin
admin.serviceAnnouncement.CreateIssues body → 2XX4XX5XX
GET
/admin/serviceAnnouncement/issues/{serviceHealthIssue-id}
Microsoft Graph Get serviceHealthIssue
admin.serviceAnnouncement.GetIssues 3 params → 2XX4XX5XX
PATCH
/admin/serviceAnnouncement/issues/{serviceHealthIssue-id}
Microsoft Graph Update the navigation property issues in admin
admin.serviceAnnouncement.UpdateIssues 1 param body → 2XX4XX5XX
DELETE
/admin/serviceAnnouncement/issues/{serviceHealthIssue-id}
Microsoft Graph Delete navigation property issues for admin
admin.serviceAnnouncement.DeleteIssues 2 params → 2044XX5XX
GET
/admin/serviceAnnouncement/issues/{serviceHealthIssue-id}/incidentReport()
Microsoft Graph Invoke function incidentReport
admin.serviceAnnouncement.issues.serviceHealthIssue.incidentReport 1 param → 2XX4XX5XX
GET
/admin/serviceAnnouncement/issues/$count
Microsoft Graph Get the number of the resource
admin.serviceAnnouncement.issues.GetCount-e140 2 params → 2XX4XX5XX

Schemas 28

The contract defines 28 schemas that model the data the API accepts and returns. The most detailed are microsoft.graph.ODataErrors.MainError (5 properties), microsoft.graph.ODataErrors.InnerError (4 properties), microsoft.graph.serviceUpdateMessageViewpoint (4 properties), microsoft.graph.serviceHealthIssuePost (4 properties). Each schema is shown below with its type and property counts.

ODataCountResponse
integer
microsoft.graph.serviceAnnouncementBase
microsoft.graph.ODataErrors.ErrorDetails
object
3 properties 2 required
microsoft.graph.serviceHealthOrigin
string
microsoft.graph.serviceUpdateMessageViewpoint
object
4 properties 1 required
microsoft.graph.serviceHealthClassificationType
string
microsoft.graph.itemBody
object
3 properties 1 required
microsoft.graph.ODataErrors.InnerError
object
4 properties 1 required
microsoft.graph.serviceHealth
microsoft.graph.keyValuePair
object
3 properties 1 required
microsoft.graph.serviceUpdateSeverity
string
microsoft.graph.serviceAnnouncementAttachment
microsoft.graph.serviceHealthIssuePost
object
4 properties 1 required
microsoft.graph.serviceHealthCollectionResponse
object
microsoft.graph.bodyType
string
microsoft.graph.serviceAnnouncementAttachmentCollectionResponse
object
microsoft.graph.serviceUpdateMessage
microsoft.graph.ODataErrors.MainError
object
5 properties 2 required
microsoft.graph.serviceHealthIssueCollectionResponse
object
microsoft.graph.serviceAnnouncement
microsoft.graph.serviceHealthIssue
microsoft.graph.serviceUpdateMessageCollectionResponse
object
microsoft.graph.serviceHealthStatus
string
microsoft.graph.serviceUpdateCategory
string
microsoft.graph.postType
string
BaseCollectionPaginationCountResponse
object
2 properties
microsoft.graph.ODataErrors.ODataError
object
1 property 1 required
microsoft.graph.entity
object
2 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

microsoft-graph-admin-serviceannouncement-api-openapi.yml Raw ↑

Other APIs Microsoft Graph publishes across the network.

Microsoft Graph Admin.admin API
Microsoft Graph admin.adminMicrosoft365Apps API
Microsoft Graph admin.adminReportSettings API
Microsoft Graph Admin Consent Policy API
Microsoft Graph Admin.edge API
Microsoft Graph admin.peopleAdminSettings API
Microsoft Graph Admin.sharepoint API
Microsoft Graph Administration API
Microsoft Graph Administrative Units API
Microsoft Graph Agreement Acceptances API
Microsoft Graph Agreement File Localizations API
Microsoft Graph Agreement File Versions API
Where this information came from

This is an independent, third-party profile of Microsoft Graph admin.serviceAnnouncement API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.