Graph X-Ray acts as a bridge between what you do in the Microsoft Entra or Intune portals and the underlying Graph API calls being made in real time.
I asked Merill Fernando, the creator of Graph X-Ray, to talk me through how the tool came to be and some use case scenarios.
Microsoft Graph is the unified API that connects data across Microsoft 365, from Entra ID and Teams to Exchange, Intune, and more. It’s the foundation for automation, reporting, and integration across the Microsoft ecosystem, allowing administrators and developers to query and modify nearly every aspect of a tenant through RESTful calls or SDKs.
But working directly with Graph can be tricky. It often requires deep knowledge of endpoints, permissions, and payload formats, details that can slow down even experienced PowerShell users.
That’s where Graph X-Ray comes in. Graph X-Ray acts as a bridge between what you do in the Microsoft Entra or Intune portals and the underlying Graph API calls being made in real time. It reveals exactly what’s happening behind the scenes, showing you the API requests and even converting them into PowerShell.
When you’re managing users, writing PowerShell scripts, or creating dynamic groups in Microsoft Entra, there’s often a hidden layer of complexity. You know what you want but figuring out how to make the Graph API do it can take a lot of time.
“Typically you’d have to go open up the docs, go through the API documentation, and it would take anywhere from 10–15 minutes — or if you’re new to PowerShell, maybe half an hour — to do something as simple as creating a dynamic group,” said Merill Fernando, the tool’s creator.
That repetitive grunt work, finding the right endpoints, testing calls, and translating them into scripts, is exactly what Graph X-Ray was built to eliminate.
If you’ve ever made changes in Microsoft Entra or Intune through the browser, you’ve already been using the Graph API — you just might not realize it.
“I was doing this in the browser, selecting these things, and the browser was actually making Graph API calls against the Microsoft Graph API to create this,” Merill explained.
Each dropdown selection or form submission in the portal triggers an API request behind the scenes. For admins and IT pros, those calls contain a treasure trove of insight into how Microsoft’s services really work. But unless you’re comfortable digging through browser developer tools and raw JSON payloads, that treasure is buried.
The idea for Graph X-Ray started at a Microsoft hackathon. The problem was clear: finding and understanding the right Graph API calls was too slow and too technical for many users.
“At one of the hackathons, we said, why don’t we build a browser extension — like Fiddler — that as you make changes in the browser in your tenant, it’ll give you all the APIs in a neatly formatted way so you can easily figure out what’s happening?”
That simple concept evolved into Graph X-Ray, a browser extension that intercepts and formats Graph API calls in real time. The tool watches the portal as you work and instantly displays the Graph requests, showing you exactly what Microsoft’s own interfaces are doing under the hood.
“Suddenly you can go from making some changes in the portal to, on the right-hand side in this Chrome extension, seeing all the PowerShell scripts for those changes. You can go from 15 minutes to under a minute.”
When you open a blade in the Microsoft Entra or Intune admin portal, the portal makes API calls to Microsoft Graph. Graph X-Ray listens for those calls, captures them, and then, using an internal Microsoft API, automatically converts the REST API into PowerShell, C#, Java, or Go.
If you’ve ever seen Microsoft’s documentation that shows code samples in multiple languages, that same backend system is powering Graph X-Ray’s conversions.
“Someone figured out there’s actually another internal API that Microsoft uses for the docs… to convert the REST API to various languages like PowerShell or C#. We plugged that in.”
The result is an immediate side-by-side view: make a change in the Entra portal, and Graph X-Ray generates the corresponding PowerShell command. Need to tweak it? You can copy and modify the code directly.
For administrators, Graph X-Ray bridges the gap between UI convenience and API control.
“It’s a really easy way to understand what’s going on behind the scenes. People like the Intune folks love this because you can quickly see what’s happening without having to read a bunch of documentation.”
Even for developers, the extension provides clarity. Microsoft’s portals often batch multiple Graph calls together or mix in internal APIs, something that’s nearly impossible to untangle manually.
“Graph X-Ray explodes all those out into individual top-level calls, so it’s really easy to figure out what’s happening.”
Graph X-Ray shines anywhere the Microsoft Graph API is used extensively, particularly in Entra ID, Intune, and user or group management workflows.
However, not every portal blade uses Graph under the hood.
“It only catches the blade that you’re looking at in the admin portal if it’s using Graph API calls. Some use internal first-party APIs which won’t show up in Graph X-Ray.”
In other words, if you’re working in areas like application management, you might not see much activity. But in the most common admin areas, users, groups, devices, it’s a goldmine.
The power of Graph X-Ray isn’t just in saving time, it’s in making the invisible visible. It demystifies the Graph API and gives every admin, not just developers, the ability to understand and automate Microsoft 365.
“You have a nice visual UI, and you get the PowerShell script from that. It’s a very, very handy tool to have in your toolkit.”
If you’re ready to see what’s happening behind the scenes in your own tenant, here’s how to get started with Graph X-Ray:
“You can go from doing things manually in the portal to seeing the PowerShell output instantly — and understand exactly what’s happening under the hood.”
Graph X-Ray turns Microsoft’s own portals into a live learning lab for automation. By surfacing the exact Graph API calls your browser makes, it helps you write better scripts, faster. No documentation deep dives required.
What started as a hackathon experiment has become an indispensable tool for IT professionals everywhere who want to understand and harness Microsoft Graph.