Microsoft Entra ID (formerly Azure AD)

Microsoft Entra ID (formerly Azure AD) Users.item Insights API

The users.itemInsights API from Microsoft Entra ID (formerly Azure AD) — 14 operation(s) for users.iteminsights.

GitHub OpenAPI

Operations 25

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /users/{user-id}/insights Get a user's item insights · Get insights from users #
Ask an LLM
“How do I see the document insights Microsoft Graph has calculated for a user?”
“Can I pull a user's shared, trending and used documents together in one response?”
Tell an agent
Get the item insights container for user {user}.
Show insights for user {user} and expand {relationship}.
PATCH /users/{user-id}/insights Update a user's item insights container · Update the navigation property insights in users #
Ask an LLM
“Is there a patch call for a user's top-level insights object?”
“Can I update the insights container on a user account?”
Tell an agent
Update the insights container for user {user}.
Patch the top-level item insights object on user {user}.
DELETE /users/{user-id}/insights Delete a user's item insights · Delete navigation property insights for users #
Ask an LLM
“Can I wipe the calculated document insights for a user?”
“What removes the whole insights object from a user rather than one item?”
Tell an agent destructive · confirm first
Delete the item insights for user {user}.
Remove the entire insights container from user {user}.
GET /users/{user-id}/insights/shared List documents shared with or by a user · Get shared from users #
Ask an LLM
“Which files have been shared with or by a particular user recently?”
“Can I filter a user's shared-document insights to one kind of attachment?”
Tell an agent
List the documents shared with or by user {user}.
List the {count} most recent shared-document insights for user {user}.
POST /users/{user-id}/insights/shared Add a shared-document insight for a user · Create new navigation property to shared for users #
Ask an LLM
“Can I add a shared insight record to a user's insights?”
“Is it possible to create a shared-item entry with its sharing history?”
Tell an agent
Create a shared insight for user {user} pointing at {resourceReference}.
Add a shared-document insight for user {user} with sharing history {history}.
GET /users/{user-id}/insights/shared/{sharedInsight-id} Get one shared-document insight · Get shared from users #
Ask an LLM
“What details are stored for one specific shared-document insight?”
“When was a particular shared file last shared with the user?”
Tell an agent
Get shared insight {insight} for user {user}.
Show when shared item {insight} was last shared with user {user}.
PATCH /users/{user-id}/insights/shared/{sharedInsight-id} Update a shared-document insight · Update the navigation property shared in users #
Ask an LLM
“Can I change the visualization details on an existing shared insight?”
“Is a shared insight's sharing history editable after it exists?”
Tell an agent
Update the resource visualization of shared insight {insight} for user {user} to {visualization}.
Patch the sharing history on shared insight {insight} of user {user}.
DELETE /users/{user-id}/insights/shared/{sharedInsight-id} Delete a shared-document insight · Delete navigation property shared for users #
Ask an LLM
“Can I remove one shared-document insight from a user's list?”
“How would I delete a single shared item record from a user's insights?”
Tell an agent destructive · confirm first
Delete shared insight {insight} from user {user}.
Remove shared-document record {insight} for user {user}.
GET /users/{user-id}/insights/shared/{sharedInsight-id}/lastSharedMethod See how a shared document was last shared · Get lastSharedMethod from users #
Ask an LLM
“How was a shared file most recently sent to the user, by email or another route?”
“Where do I find the last sharing method for a shared-document insight?”
Tell an agent
Get the last shared method for shared insight {insight} of user {user}.
Show the item that carried the most recent share of {insight} to user {user}.
GET /users/{user-id}/insights/shared/{sharedInsight-id}/resource Open the item behind a shared insight · Get resource from users #
Ask an LLM
“How do I navigate from a shared insight to the actual file or attachment?”
“Is the resource behind a shared insight a file attachment or a drive item?”
Tell an agent
Get the underlying shared item for shared insight {insight} of user {user}.
Open the file that shared insight {insight} refers to for user {user}.
GET /users/{user-id}/insights/shared/$count Count a user's shared-document insights · Get the number of the resource #
Ask an LLM
“How many documents have been shared with or by a given user?”
“Can I count only the shared insights that match a filter?”
Tell an agent
Count the shared-document insights for user {user}.
Count user {user}'s shared insights matching {filter}.
GET /users/{user-id}/insights/trending List documents trending around a user · Get trending from users #
Ask an LLM
“What documents are trending among the people a user works with most closely?”
“Can I sort a user's trending documents by weight?”
Tell an agent
List trending documents for user {user}.
List trending documents for user {user} ordered by {order}.
POST /users/{user-id}/insights/trending Add a trending-document insight for a user · Create new navigation property to trending for users #
Ask an LLM
“Can I add a trending item to a user's insights with a relevance weight?”
“Is it possible to create a trending-document entry manually?”
Tell an agent
Create a trending insight for user {user} with weight {weight}.
Add a trending-document entry for user {user} referencing {resourceReference}.
GET /users/{user-id}/insights/trending/{trending-id} Get one trending-document insight · Get trending from users #
Ask an LLM
“How strongly is a specific document trending for a user?”
“What does a single trending insight record contain?”
Tell an agent
Get trending insight {trending} for user {user}.
Show the weight and last-modified time of trending item {trending} for user {user}.
PATCH /users/{user-id}/insights/trending/{trending-id} Update a trending-document insight · Update the navigation property trending in users #
Ask an LLM
“Can I adjust the weight on an existing trending insight?”
“Is the last-modified time of a trending record editable?”
Tell an agent
Set the weight of trending insight {trending} for user {user} to {weight}.
Update the resource visualization on trending item {trending} for user {user}.
DELETE /users/{user-id}/insights/trending/{trending-id} Delete a trending-document insight · Delete navigation property trending for users #
Ask an LLM
“Can I remove a document from a user's trending insights?”
“How do I delete a single trending record for a user?”
Tell an agent destructive · confirm first
Delete trending insight {trending} from user {user}.
Remove trending document {trending} from user {user}'s insights.
GET /users/{user-id}/insights/trending/{trending-id}/resource Open the document behind a trending insight · Get resource from users #
Ask an LLM
“How do I get to the actual document that a trending insight points at?”
“What item is behind a given trending record?”
Tell an agent
Get the trending document behind insight {trending} for user {user}.
Open the file that trending item {trending} refers to for user {user}.
GET /users/{user-id}/insights/trending/$count Count a user's trending-document insights · Get the number of the resource #
Ask an LLM
“How many documents are trending around a particular user?”
“Can I count trending insights that match a filter?”
Tell an agent
Count trending documents for user {user}.
Count user {user}'s trending insights matching {filter}.
GET /users/{user-id}/insights/used List documents a user recently viewed or edited · Get used from users #
Ask an LLM
“Which OneDrive and SharePoint documents has a user opened or modified lately?”
“Can I see a user's recently used files ordered by last access?”
Tell an agent
List the documents user {user} recently viewed or modified.
List used-document insights for user {user} filtered by {filter}.
POST /users/{user-id}/insights/used Add a used-document insight for a user · Create new navigation property to used for users #
Ask an LLM
“Can I add a recently-used document record to a user's insights?”
“Is it possible to create a used insight with its last-used details?”
Tell an agent
Create a used insight for user {user} with last-used info {lastUsed}.
Add a recently used document entry for user {user} referencing {resourceReference}.
GET /users/{user-id}/insights/used/{usedInsight-id} Get one used-document insight · Get used from users #
Ask an LLM
“When did a user last access a specific document in their used insights?”
“What details does a single used insight record hold?”
Tell an agent
Get used insight {used} for user {user}.
Show when user {user} last accessed used item {used}.
PATCH /users/{user-id}/insights/used/{usedInsight-id} Update a used-document insight · Update the navigation property used in users #
Ask an LLM
“Can I change the last-used details on an existing used insight?”
“Is a used insight's visualization editable?”
Tell an agent
Update last-used info on used insight {used} for user {user} to {lastUsed}.
Patch the resource visualization of used item {used} for user {user}.
DELETE /users/{user-id}/insights/used/{usedInsight-id} Delete a used-document insight · Delete navigation property used for users #
Ask an LLM
“Can I remove a document from a user's recently used insights?”
“How do I delete a single used-document record?”
Tell an agent destructive · confirm first
Delete used insight {used} from user {user}.
Remove recently used document {used} from user {user}'s insights.
GET /users/{user-id}/insights/used/{usedInsight-id}/resource Open the item behind a used insight · Get resource from users #
Ask an LLM
“How do I navigate from a used insight to the file the user actually worked on?”
“Is the item behind a used insight a drive item or an attachment?”
Tell an agent
Get the underlying item for used insight {used} of user {user}.
Open the document that used record {used} refers to for user {user}.
GET /users/{user-id}/insights/used/$count Count a user's used-document insights · Get the number of the resource #
Ask an LLM
“How many documents has a user recently viewed or modified?”
“Can I count used insights that match a filter?”
Tell an agent
Count the used-document insights for user {user}.
Count user {user}'s used insights matching {filter}.

Documentation

📖
Documentation
https://learn.microsoft.com/en-us/graph/api/overview
📖
Authentication
https://learn.microsoft.com/en-us/graph/auth/
📖
Documentation
https://learn.microsoft.com/en-us/graph/change-notifications-overview

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-users-iteminsights-api-openapi.yml

Other Resources

🔗
SDKs
https://learn.microsoft.com/en-us/graph/sdks/sdks-overview
🔗
ChangeLog
https://developer.microsoft.com/en-us/graph/changelog
🔗
Webhooks
https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/asyncapi/azure-ad-change-notifications-webhooks.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/azure-ad:azure-ad-users-iteminsights-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

azure-ad-users-iteminsights-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Users.item Insights API
  version: v1.0
servers:
- url: https://graph.microsoft.com/v1.0/
  description: Core
security:
- azureaadv2: []
tags:


# --- truncated at 32 KB (49 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/azure-ad/refs/heads/main/openapi/azure-ad-users-iteminsights-api-openapi.yml