Microsoft Graph Me
Microsoft Graph “Me” is a shortcut to the signed-in user’s resource, letting apps work with the current user’s data across Microsoft 365 without knowing their user ID.
OpenAPI Specification
openapi: 3.1.0
info:
title: Microsoft Graph Me
description: Needs a description.
paths:
/admin/serviceAnnouncement/messages:
description: >-
Provides operations to manage the messages property of the
microsoft.graph.serviceAnnouncement entity.
get:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph List serviceAnnouncement messages
description: >-
Retrieve the serviceUpdateMessage resources from the messages navigation
property. This operation retrieves all service update messages that
exist for the tenant.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceannouncement-list-messages?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.ListMessages
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.serviceUpdateMessageCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Create new navigation property to messages for admin
operationId: admin.serviceAnnouncement.CreateMessages
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.serviceUpdateMessage'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.serviceUpdateMessage'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}:
description: >-
Provides operations to manage the messages property of the
microsoft.graph.serviceAnnouncement entity.
get:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Get serviceUpdateMessage
description: >-
Retrieve the properties and relationships of a serviceUpdateMessage
object. This operation retrieves a specified service update message for
the tenant. The operation returns an error if the message does not exist
for the tenant.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceupdatemessage-get?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.GetMessages
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.serviceUpdateMessage'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Update the navigation property messages in admin
operationId: admin.serviceAnnouncement.UpdateMessages
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.serviceUpdateMessage'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.serviceUpdateMessage'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Delete navigation property messages for admin
operationId: admin.serviceAnnouncement.DeleteMessages
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: serviceUpdateMessage-id
in: path
description: The unique identifier of serviceUpdateMessage
required: true
schema:
type: string
x-ms-docs-key-type: serviceUpdateMessage
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments:
description: >-
Provides operations to manage the attachments property of the
microsoft.graph.serviceUpdateMessage entity.
get:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph List attachments
description: Get the list of attachments associated with a service message.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceupdatemessage-list-attachments?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.messages.ListAttachments
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.serviceAnnouncementAttachmentCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Create new navigation property to attachments for admin
operationId: admin.serviceAnnouncement.messages.CreateAttachments
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: >-
#/components/schemas/microsoft.graph.serviceAnnouncementAttachment
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: >-
#/components/schemas/microsoft.graph.serviceAnnouncementAttachment
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: serviceUpdateMessage-id
in: path
description: The unique identifier of serviceUpdateMessage
required: true
schema:
type: string
x-ms-docs-key-type: serviceUpdateMessage
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments/{serviceAnnouncementAttachment-id}:
description: >-
Provides operations to manage the attachments property of the
microsoft.graph.serviceUpdateMessage entity.
get:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Get serviceAnnouncementAttachment
description: >-
Read the properties and relationships of a serviceAnnouncementAttachment
object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceannouncementattachment-get?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.messages.GetAttachments
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: >-
#/components/schemas/microsoft.graph.serviceAnnouncementAttachment
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Update the navigation property attachments in admin
operationId: admin.serviceAnnouncement.messages.UpdateAttachments
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: >-
#/components/schemas/microsoft.graph.serviceAnnouncementAttachment
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: >-
#/components/schemas/microsoft.graph.serviceAnnouncementAttachment
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Delete navigation property attachments for admin
operationId: admin.serviceAnnouncement.messages.DeleteAttachments
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: serviceUpdateMessage-id
in: path
description: The unique identifier of serviceUpdateMessage
required: true
schema:
type: string
x-ms-docs-key-type: serviceUpdateMessage
- name: serviceAnnouncementAttachment-id
in: path
description: The unique identifier of serviceAnnouncementAttachment
required: true
schema:
type: string
x-ms-docs-key-type: serviceAnnouncementAttachment
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments/{serviceAnnouncementAttachment-id}/content:
description: Provides operations to manage the media for the admin entity.
get:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Get serviceAnnouncementAttachment
description: >-
Read the properties and relationships of a serviceAnnouncementAttachment
object.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceannouncementattachment-get?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.messages.GetAttachmentsContent
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
put:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Update content for the navigation property attachments in admin
description: The attachment content.
operationId: admin.serviceAnnouncement.messages.UpdateAttachmentsContent
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: >-
#/components/schemas/microsoft.graph.serviceAnnouncementAttachment
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
delete:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Delete content for the navigation property attachments in admin
description: The attachment content.
operationId: admin.serviceAnnouncement.messages.DeleteAttachmentsContent
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
parameters:
- name: serviceUpdateMessage-id
in: path
description: The unique identifier of serviceUpdateMessage
required: true
schema:
type: string
x-ms-docs-key-type: serviceUpdateMessage
- name: serviceAnnouncementAttachment-id
in: path
description: The unique identifier of serviceAnnouncementAttachment
required: true
schema:
type: string
x-ms-docs-key-type: serviceAnnouncementAttachment
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachments/$count:
description: Provides operations to count the resources in the collection.
get:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Get the number of the resource
operationId: admin.serviceAnnouncement.messages.attachments.GetCount-e0ef
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
parameters:
- name: serviceUpdateMessage-id
in: path
description: The unique identifier of serviceUpdateMessage
required: true
schema:
type: string
x-ms-docs-key-type: serviceUpdateMessage
/admin/serviceAnnouncement/messages/{serviceUpdateMessage-id}/attachmentsArchive:
description: Provides operations to manage the media for the admin entity.
get:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph List attachments
description: Get the list of attachments associated with a service message.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceupdatemessage-list-attachments?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.GetMessagesAttachmentsArchive
responses:
2XX:
description: Retrieved media content
content:
application/octet-stream:
schema:
type: string
format: binary
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
put:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Update attachmentsArchive for the navigation property messages in admin
description: The zip file that contains all attachments for a message.
operationId: admin.serviceAnnouncement.UpdateMessagesAttachmentsArchive
requestBody:
description: New media content.
content:
application/octet-stream:
schema:
type: string
format: binary
required: true
responses:
2XX:
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
delete:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Delete attachmentsArchive for the navigation property messages in admin
description: The zip file that contains all attachments for a message.
operationId: admin.serviceAnnouncement.DeleteMessagesAttachmentsArchive
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
parameters:
- name: serviceUpdateMessage-id
in: path
description: The unique identifier of serviceUpdateMessage
required: true
schema:
type: string
x-ms-docs-key-type: serviceUpdateMessage
/admin/serviceAnnouncement/messages/$count:
description: Provides operations to count the resources in the collection.
get:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Get the number of the resource
operationId: admin.serviceAnnouncement.messages.GetCount-0cc9
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
/admin/serviceAnnouncement/messages/archive:
description: Provides operations to call the archive method.
post:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Invoke action archive
description: Archive a list of serviceUpdateMessages for the signed in user.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceupdatemessage-archive?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.messages.archive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
messageIds:
type: array
items:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: boolean
default: false
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/admin/serviceAnnouncement/messages/favorite:
description: Provides operations to call the favorite method.
post:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Invoke action favorite
description: >-
Change the status of a list of serviceUpdateMessages to favorite for the
signed in user.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceupdatemessage-favorite?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.messages.favorite
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
messageIds:
type: array
items:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: boolean
default: false
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/admin/serviceAnnouncement/messages/markRead:
description: Provides operations to call the markRead method.
post:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Invoke action markRead
description: Mark a list of serviceUpdateMessages as read for the signed in user.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceupdatemessage-markread?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.messages.markRead
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
messageIds:
type: array
items:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: boolean
default: false
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/admin/serviceAnnouncement/messages/markUnread:
description: Provides operations to call the markUnread method.
post:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Invoke action markUnread
description: Mark a list of serviceUpdateMessages as unread for the signed in user.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceupdatemessage-markunread?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.messages.markUnread
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
messageIds:
type: array
items:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: boolean
default: false
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/admin/serviceAnnouncement/messages/unarchive:
description: Provides operations to call the unarchive method.
post:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Invoke action unarchive
description: Unarchive a list of serviceUpdateMessages for the signed in user.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceupdatemessage-unarchive?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.messages.unarchive
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
messageIds:
type: array
items:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: boolean
default: false
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/admin/serviceAnnouncement/messages/unfavorite:
description: Provides operations to call the unfavorite method.
post:
tags:
- admin.serviceAnnouncement
summary: Microsoft Graph Invoke action unfavorite
description: >-
Remove the favorite status of serviceUpdateMessages for the signed in
user.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/serviceupdatemessage-unfavorite?view=graph-rest-1.0
operationId: admin.serviceAnnouncement.messages.unfavorite
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
messageIds:
type: array
items:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
type: object
properties:
value:
type: boolean
default: false
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/chats/{chat-id}/members:
description: >-
Provides operations to manage the members property of the
microsoft.graph.chat entity.
get:
tags:
- chats.conversationMember
summary: Microsoft Graph List conversationMembers
description: List all conversation members in a chat or channel.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/conversationmember-list?view=graph-rest-1.0
operationId: chats.ListMembers
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.conversationMemberCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- chats.conversationMember
summary: Microsoft Graph Add member to a chat
description: Add a conversationMember to a chat.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/chat-post-members?view=graph-rest-1.0
operationId: chats.CreateMembers
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.conversationMember'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: chat-id
in: path
description: The unique identifier of chat
required: true
schema:
type: string
x-ms-docs-key-type: chat
/chats/{chat-id}/members/{conversationMember-id}:
description: >-
Provides operations to manage the members property of the
microsoft.graph.chat entity.
get:
tags:
- chats.conversationMember
summary: Microsoft Graph Get conversationMember in a chat
description: Retrieve a conversationMember from a chat.
externalDocs:
description: Find more info here
url: >-
https://learn.microsoft.com/graph/api/chat-get-members?view=graph-rest-1.0
operationId: chats.GetMembers
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: t
# --- truncated at 32 KB (4754 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/me-openapi-original.yml