Exchange Online is introducing two new subfields, 'ClientAppId' and 'APIId', under 'AppAccessContext' for better telemetry in Exchange APIs. Rollouts begin late October 2024, with no admin action required. Post-update, admins should review workflows to accommodate these changes for seamless operations.
MC909164 – Coming soon to Microsoft Exchange Online: A significant rollout that introduces two new subfields under AppAccessContext
for improved field consistency and enhanced telemetry in other Exchange APIs:
ClientAppId
APIId
When this will happen:
General Availability (Worldwide): Microsoft will begin rolling out late October 2024 and expects to complete by mid-November 2024.
General Availability (GCC, GCC High): Microsoft will begin rolling out late November 2024 and expects to complete by late November 2024.
General Availability (DoD): Microsoft will begin rolling out early December 2024 and expects to complete by early December 2024.
How this will affect your organization:
Before this rollout: The ClientAppId
and AppAccessContext
fields exist across previous schemas outside of the Microsoft Exchange Web Service (EWS) schema.
After this rollout: The AppAccessContext
field, which serves a similar purpose to the ClientAppId
field, will be in EWS schema with two new subfields: ClientAppId
and APIId
. This update is on by default. The ClientAppId
field and the ClientAppId
subfield under the AppAccessContext
field will both be populated more consistently and robustly with a new fallback.
Field definitions
AppAccessContext
: Used to provide additional information about the application context in which an event or action occurs. This field helps in tracking and auditing purposes by identifying the specific application or service involved in each operation.
ClientAppId
: The original field used to identify the application that initiated a particular action or event. After this rollout, this subfield will have a new fallback to enhance capabilities.APIId
: Used to uniquely identify an API endpoint or service. This subfield is particularly useful in scenarios where admins need to filter or track activities specific to certain APIs, such as the Microsoft Exchange Web Service (EWS).What you need to do to prepare:
This rollout will happen automatically by the specified date with no admin action required before the rollout.
After the rollout, Microsoft recommends admins review and update your workflows to accommodate both the ClientAppId
and AppAccessContext
fields. This will ensure that your operations continue seamlessly and leverage the new features effectively.
Accessing and using the new fields
AppAccessContext
and ClientAppId
fields. You may need to specify the event types or actions that involve these fields.AppAccessContext
and ClientAppId
fields. These fields provide additional information about the application context and the client application involved in each operation.Learn more
Mailbox audit logging in Exchange Server | Microsoft Learn
The Engage Mailbox schema section in Office 365 Management Activity API schema | Microsoft Learn
Previous Exchange Online Changelog Messages
Whether it’s Security or Cloud Computing, we have the know-how for you. Sign up for our newsletters here.