Skip to main content

graph changelog list

Gets an overview of specific API-level changes in Microsoft Graph v1.0 and beta

Usage​

m365 graph changelog list [options]

Options​

-v, --versions [versions]

Comma-separated list of versions to show changes for. Beta, v1.0. When no version is selected all versions are returned.

-c, --changeType [changeType]

Change type to show changes for. Addition, Change, Deletion. When no changeType is selected all change types are returned.

-s, --services [services]

Comma-separated list of services to show changes for. Applications, Calendar, Change notifications, Cloud communications, Compliance, Cross-device experiences, Customer booking, Device and app management, Education, Files, Financials, Groups, Identity and access, Mail, Notes, Notifications, People and workplace intelligence, Personal contacts, Reports, Search, Security, Sites and lists, Tasks and plans, Teamwork, To-do tasks, Users, Workbooks and charts. When no service is selected all services are returned.

--startDate [startDate]

The startdate used to query for changes. Supported date format is YYYY-MM-DD. When no date is specified all changes are returned.

--endDate [endDate]

The enddate used to query for changes. Supported date format is YYYY-MM-DD. When no date is specified all changes are returned.

-h, --help [help]

Output usage information. Optionally, specify which section of command's help you want to see. Allowed values are options, examples, remarks, response, full. Default is options.

--query [query]

JMESPath query string. See http://jmespath.org/ for more information and examples.

-o, --output [output]

Output type. json, text, csv, md, none. Default json.

--verbose

Runs command with verbose logging.

--debug

Runs command with debug logging.

Remarks​

warning

This command is based on an API that is currently in preview and is subject to change once the API reached general availability.

Examples​

Get all changes within Microsoft Graph.

m365 graph changelog list

Get all changes within Microsoft Graph for the services Groups and Users.

m365 graph changelog list --services 'Groups,Users'

Get all changes within Microsoft Graph that happend between 2021-01-01 and 2021-05-01.

m365 graph changelog list --startDate '2021-01-01' --endDate '2021-05-01'

Response​

[
  {
    "guid": "2693683c-f49a-4715-a649-edadd3f54aadv1.0",
    "category": "v1.0",
    "title": "Teamwork and communications",
    "description": "Added the **chatMessageActions** enumeration type.\r\\\nAdded the [chatMessageHistoryItem](https://learn.microsoft.com/graph/api/resources/chatMessageHistoryItem?view=graph-rest-1.0) resource type.\r\\\nAdded the **messageHistory** property to the [chatMessage](https://learn.microsoft.com/graph/api/resources/chatMessage?view=graph-rest-1.0) resource.\r\\\n",
    "pubDate": "2023-05-18T23:04:05.000Z"
  }
]
CTRL + M