naftiko: 1.0.0-alpha2 info: label: Microsoft Graph OData Service for namespace microsoft.graph — users.itemInsights description: 'Microsoft Graph OData Service for namespace microsoft.graph — users.itemInsights. 25 operations. Lead operation: Microsoft Graph Get insights from users. Self-contained Naftiko capability covering one Microsoft Graph business surface.' tags: - Microsoft Graph - users.itemInsights created: '2026-05-19' modified: '2026-05-19' binds: - namespace: env keys: MICROSOFT_GRAPH_API_KEY: MICROSOFT_GRAPH_API_KEY capability: consumes: - type: http namespace: microsoft-graph-users-iteminsights baseUri: https://graph.microsoft.com/v1.0 description: Microsoft Graph OData Service for namespace microsoft.graph — users.itemInsights business capability. Self-contained, no shared references. resources: - name: users-user-id-insights path: /users/{user-id}/insights operations: - name: usersgetinsights method: GET description: Microsoft Graph Get insights from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities - name: usersupdateinsights method: PATCH description: Microsoft Graph Update the navigation property insights in users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: usersdeleteinsights method: DELETE description: Microsoft Graph Delete navigation property insights for users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: If-Match in: header type: string description: ETag - name: users-user-id-insights-shared path: /users/{user-id}/insights/shared operations: - name: usersinsightslistshared method: GET description: Microsoft Graph Get shared from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $orderby in: query type: array description: Order items by property values - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities - name: usersinsightscreateshared method: POST description: Microsoft Graph Create new navigation property to shared for users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: users-user-id-insights-shared-$count path: /users/{user-id}/insights/shared/$count operations: - name: usersinsightssharedgetcountbfe2 method: GET description: Microsoft Graph Get the number of the resource outputRawFormat: json outputParameters: - name: result type: object value: $. - name: users-user-id-insights-shared-sharedInsight-id path: /users/{user-id}/insights/shared/{sharedInsight-id} operations: - name: usersinsightsgetshared method: GET description: Microsoft Graph Get shared from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities - name: usersinsightsupdateshared method: PATCH description: Microsoft Graph Update the navigation property shared in users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: usersinsightsdeleteshared method: DELETE description: Microsoft Graph Delete navigation property shared for users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: If-Match in: header type: string description: ETag - name: users-user-id-insights-shared-sharedInsight-id-lastSharedMethod path: /users/{user-id}/insights/shared/{sharedInsight-id}/lastSharedMethod operations: - name: usersinsightssharedgetlastsharedmethod method: GET description: Microsoft Graph Get lastSharedMethod from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities - name: users-user-id-insights-shared-sharedInsight-id-resource path: /users/{user-id}/insights/shared/{sharedInsight-id}/resource operations: - name: usersinsightssharedgetresource method: GET description: Microsoft Graph Get resource from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities - name: users-user-id-insights-trending path: /users/{user-id}/insights/trending operations: - name: usersinsightslisttrending method: GET description: Microsoft Graph Get trending from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $orderby in: query type: array description: Order items by property values - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities - name: usersinsightscreatetrending method: POST description: Microsoft Graph Create new navigation property to trending for users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: users-user-id-insights-trending-$count path: /users/{user-id}/insights/trending/$count operations: - name: usersinsightstrendinggetcount9a67 method: GET description: Microsoft Graph Get the number of the resource outputRawFormat: json outputParameters: - name: result type: object value: $. - name: users-user-id-insights-trending-trending-id path: /users/{user-id}/insights/trending/{trending-id} operations: - name: usersinsightsgettrending method: GET description: Microsoft Graph Get trending from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities - name: usersinsightsupdatetrending method: PATCH description: Microsoft Graph Update the navigation property trending in users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: usersinsightsdeletetrending method: DELETE description: Microsoft Graph Delete navigation property trending for users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: If-Match in: header type: string description: ETag - name: users-user-id-insights-trending-trending-id-resource path: /users/{user-id}/insights/trending/{trending-id}/resource operations: - name: usersinsightstrendinggetresource method: GET description: Microsoft Graph Get resource from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities - name: users-user-id-insights-used path: /users/{user-id}/insights/used operations: - name: usersinsightslistused method: GET description: Microsoft Graph Get used from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $orderby in: query type: array description: Order items by property values - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities - name: usersinsightscreateused method: POST description: Microsoft Graph Create new navigation property to used for users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: users-user-id-insights-used-$count path: /users/{user-id}/insights/used/$count operations: - name: usersinsightsusedgetcountd5af method: GET description: Microsoft Graph Get the number of the resource outputRawFormat: json outputParameters: - name: result type: object value: $. - name: users-user-id-insights-used-usedInsight-id path: /users/{user-id}/insights/used/{usedInsight-id} operations: - name: usersinsightsgetused method: GET description: Microsoft Graph Get used from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities - name: usersinsightsupdateused method: PATCH description: Microsoft Graph Update the navigation property used in users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: body in: body type: object description: Request body (JSON). required: true - name: usersinsightsdeleteused method: DELETE description: Microsoft Graph Delete navigation property used for users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: If-Match in: header type: string description: ETag - name: users-user-id-insights-used-usedInsight-id-resource path: /users/{user-id}/insights/used/{usedInsight-id}/resource operations: - name: usersinsightsusedgetresource method: GET description: Microsoft Graph Get resource from users outputRawFormat: json outputParameters: - name: result type: object value: $. inputParameters: - name: $select in: query type: array description: Select properties to be returned - name: $expand in: query type: array description: Expand related entities exposes: - type: rest namespace: microsoft-graph-users-iteminsights-rest port: 8080 description: REST adapter for Microsoft Graph OData Service for namespace microsoft.graph — users.itemInsights. One Spectral-compliant resource per consumed operation, prefixed with /v1. resources: - path: /v1/users/{user-id}/insights name: users-user-id-insights description: REST surface for users-user-id-insights. operations: - method: GET name: usersgetinsights description: Microsoft Graph Get insights from users call: microsoft-graph-users-iteminsights.usersgetinsights with: $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - method: PATCH name: usersupdateinsights description: Microsoft Graph Update the navigation property insights in users call: microsoft-graph-users-iteminsights.usersupdateinsights with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: usersdeleteinsights description: Microsoft Graph Delete navigation property insights for users call: microsoft-graph-users-iteminsights.usersdeleteinsights with: If-Match: rest.If-Match outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/shared name: users-user-id-insights-shared description: REST surface for users-user-id-insights-shared. operations: - method: GET name: usersinsightslistshared description: Microsoft Graph Get shared from users call: microsoft-graph-users-iteminsights.usersinsightslistshared with: $orderby: rest.$orderby $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - method: POST name: usersinsightscreateshared description: Microsoft Graph Create new navigation property to shared for users call: microsoft-graph-users-iteminsights.usersinsightscreateshared with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/shared/count name: users-user-id-insights-shared-count description: REST surface for users-user-id-insights-shared-$count. operations: - method: GET name: usersinsightssharedgetcountbfe2 description: Microsoft Graph Get the number of the resource call: microsoft-graph-users-iteminsights.usersinsightssharedgetcountbfe2 outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/shared/{sharedinsight-id} name: users-user-id-insights-shared-sharedinsight-id description: REST surface for users-user-id-insights-shared-sharedInsight-id. operations: - method: GET name: usersinsightsgetshared description: Microsoft Graph Get shared from users call: microsoft-graph-users-iteminsights.usersinsightsgetshared with: $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - method: PATCH name: usersinsightsupdateshared description: Microsoft Graph Update the navigation property shared in users call: microsoft-graph-users-iteminsights.usersinsightsupdateshared with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: usersinsightsdeleteshared description: Microsoft Graph Delete navigation property shared for users call: microsoft-graph-users-iteminsights.usersinsightsdeleteshared with: If-Match: rest.If-Match outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/shared/{sharedinsight-id}/lastsharedmethod name: users-user-id-insights-shared-sharedinsight-id-lastsharedmethod description: REST surface for users-user-id-insights-shared-sharedInsight-id-lastSharedMethod. operations: - method: GET name: usersinsightssharedgetlastsharedmethod description: Microsoft Graph Get lastSharedMethod from users call: microsoft-graph-users-iteminsights.usersinsightssharedgetlastsharedmethod with: $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/shared/{sharedinsight-id}/resource name: users-user-id-insights-shared-sharedinsight-id-resource description: REST surface for users-user-id-insights-shared-sharedInsight-id-resource. operations: - method: GET name: usersinsightssharedgetresource description: Microsoft Graph Get resource from users call: microsoft-graph-users-iteminsights.usersinsightssharedgetresource with: $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/trending name: users-user-id-insights-trending description: REST surface for users-user-id-insights-trending. operations: - method: GET name: usersinsightslisttrending description: Microsoft Graph Get trending from users call: microsoft-graph-users-iteminsights.usersinsightslisttrending with: $orderby: rest.$orderby $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - method: POST name: usersinsightscreatetrending description: Microsoft Graph Create new navigation property to trending for users call: microsoft-graph-users-iteminsights.usersinsightscreatetrending with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/trending/count name: users-user-id-insights-trending-count description: REST surface for users-user-id-insights-trending-$count. operations: - method: GET name: usersinsightstrendinggetcount9a67 description: Microsoft Graph Get the number of the resource call: microsoft-graph-users-iteminsights.usersinsightstrendinggetcount9a67 outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/trending/{trending-id} name: users-user-id-insights-trending-trending-id description: REST surface for users-user-id-insights-trending-trending-id. operations: - method: GET name: usersinsightsgettrending description: Microsoft Graph Get trending from users call: microsoft-graph-users-iteminsights.usersinsightsgettrending with: $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - method: PATCH name: usersinsightsupdatetrending description: Microsoft Graph Update the navigation property trending in users call: microsoft-graph-users-iteminsights.usersinsightsupdatetrending with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: usersinsightsdeletetrending description: Microsoft Graph Delete navigation property trending for users call: microsoft-graph-users-iteminsights.usersinsightsdeletetrending with: If-Match: rest.If-Match outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/trending/{trending-id}/resource name: users-user-id-insights-trending-trending-id-resource description: REST surface for users-user-id-insights-trending-trending-id-resource. operations: - method: GET name: usersinsightstrendinggetresource description: Microsoft Graph Get resource from users call: microsoft-graph-users-iteminsights.usersinsightstrendinggetresource with: $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/used name: users-user-id-insights-used description: REST surface for users-user-id-insights-used. operations: - method: GET name: usersinsightslistused description: Microsoft Graph Get used from users call: microsoft-graph-users-iteminsights.usersinsightslistused with: $orderby: rest.$orderby $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - method: POST name: usersinsightscreateused description: Microsoft Graph Create new navigation property to used for users call: microsoft-graph-users-iteminsights.usersinsightscreateused with: body: rest.body outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/used/count name: users-user-id-insights-used-count description: REST surface for users-user-id-insights-used-$count. operations: - method: GET name: usersinsightsusedgetcountd5af description: Microsoft Graph Get the number of the resource call: microsoft-graph-users-iteminsights.usersinsightsusedgetcountd5af outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/used/{usedinsight-id} name: users-user-id-insights-used-usedinsight-id description: REST surface for users-user-id-insights-used-usedInsight-id. operations: - method: GET name: usersinsightsgetused description: Microsoft Graph Get used from users call: microsoft-graph-users-iteminsights.usersinsightsgetused with: $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - method: PATCH name: usersinsightsupdateused description: Microsoft Graph Update the navigation property used in users call: microsoft-graph-users-iteminsights.usersinsightsupdateused with: body: rest.body outputParameters: - type: object mapping: $. - method: DELETE name: usersinsightsdeleteused description: Microsoft Graph Delete navigation property used for users call: microsoft-graph-users-iteminsights.usersinsightsdeleteused with: If-Match: rest.If-Match outputParameters: - type: object mapping: $. - path: /v1/users/{user-id}/insights/used/{usedinsight-id}/resource name: users-user-id-insights-used-usedinsight-id-resource description: REST surface for users-user-id-insights-used-usedInsight-id-resource. operations: - method: GET name: usersinsightsusedgetresource description: Microsoft Graph Get resource from users call: microsoft-graph-users-iteminsights.usersinsightsusedgetresource with: $select: rest.$select $expand: rest.$expand outputParameters: - type: object mapping: $. - type: mcp namespace: microsoft-graph-users-iteminsights-mcp port: 9090 transport: http description: MCP adapter for Microsoft Graph OData Service for namespace microsoft.graph — users.itemInsights. One tool per consumed operation, routed inline through this capability's consumes block. tools: - name: microsoft-graph-get-insights-users description: Microsoft Graph Get insights from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersgetinsights with: $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $. - name: microsoft-graph-update-navigation-property description: Microsoft Graph Update the navigation property insights in users hints: readOnly: false destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersupdateinsights with: body: tools.body outputParameters: - type: object mapping: $. - name: microsoft-graph-delete-navigation-property description: Microsoft Graph Delete navigation property insights for users hints: readOnly: false destructive: true idempotent: true call: microsoft-graph-users-iteminsights.usersdeleteinsights with: If-Match: tools.If-Match outputParameters: - type: object mapping: $. - name: microsoft-graph-get-shared-users description: Microsoft Graph Get shared from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightslistshared with: $orderby: tools.$orderby $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $. - name: microsoft-graph-create-new-navigation description: Microsoft Graph Create new navigation property to shared for users hints: readOnly: false destructive: false idempotent: false call: microsoft-graph-users-iteminsights.usersinsightscreateshared with: body: tools.body outputParameters: - type: object mapping: $. - name: microsoft-graph-get-number-resource description: Microsoft Graph Get the number of the resource hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightssharedgetcountbfe2 outputParameters: - type: object mapping: $. - name: microsoft-graph-get-shared-users-2 description: Microsoft Graph Get shared from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsgetshared with: $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $. - name: microsoft-graph-update-navigation-property-2 description: Microsoft Graph Update the navigation property shared in users hints: readOnly: false destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsupdateshared with: body: tools.body outputParameters: - type: object mapping: $. - name: microsoft-graph-delete-navigation-property-2 description: Microsoft Graph Delete navigation property shared for users hints: readOnly: false destructive: true idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsdeleteshared with: If-Match: tools.If-Match outputParameters: - type: object mapping: $. - name: microsoft-graph-get-lastsharedmethod-users description: Microsoft Graph Get lastSharedMethod from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightssharedgetlastsharedmethod with: $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $. - name: microsoft-graph-get-resource-users description: Microsoft Graph Get resource from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightssharedgetresource with: $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $. - name: microsoft-graph-get-trending-users description: Microsoft Graph Get trending from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightslisttrending with: $orderby: tools.$orderby $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $. - name: microsoft-graph-create-new-navigation-2 description: Microsoft Graph Create new navigation property to trending for users hints: readOnly: false destructive: false idempotent: false call: microsoft-graph-users-iteminsights.usersinsightscreatetrending with: body: tools.body outputParameters: - type: object mapping: $. - name: microsoft-graph-get-number-resource-2 description: Microsoft Graph Get the number of the resource hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightstrendinggetcount9a67 outputParameters: - type: object mapping: $. - name: microsoft-graph-get-trending-users-2 description: Microsoft Graph Get trending from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsgettrending with: $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $. - name: microsoft-graph-update-navigation-property-3 description: Microsoft Graph Update the navigation property trending in users hints: readOnly: false destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsupdatetrending with: body: tools.body outputParameters: - type: object mapping: $. - name: microsoft-graph-delete-navigation-property-3 description: Microsoft Graph Delete navigation property trending for users hints: readOnly: false destructive: true idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsdeletetrending with: If-Match: tools.If-Match outputParameters: - type: object mapping: $. - name: microsoft-graph-get-resource-users-2 description: Microsoft Graph Get resource from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightstrendinggetresource with: $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $. - name: microsoft-graph-get-used-users description: Microsoft Graph Get used from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightslistused with: $orderby: tools.$orderby $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $. - name: microsoft-graph-create-new-navigation-3 description: Microsoft Graph Create new navigation property to used for users hints: readOnly: false destructive: false idempotent: false call: microsoft-graph-users-iteminsights.usersinsightscreateused with: body: tools.body outputParameters: - type: object mapping: $. - name: microsoft-graph-get-number-resource-3 description: Microsoft Graph Get the number of the resource hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsusedgetcountd5af outputParameters: - type: object mapping: $. - name: microsoft-graph-get-used-users-2 description: Microsoft Graph Get used from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsgetused with: $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $. - name: microsoft-graph-update-navigation-property-4 description: Microsoft Graph Update the navigation property used in users hints: readOnly: false destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsupdateused with: body: tools.body outputParameters: - type: object mapping: $. - name: microsoft-graph-delete-navigation-property-4 description: Microsoft Graph Delete navigation property used for users hints: readOnly: false destructive: true idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsdeleteused with: If-Match: tools.If-Match outputParameters: - type: object mapping: $. - name: microsoft-graph-get-resource-users-3 description: Microsoft Graph Get resource from users hints: readOnly: true destructive: false idempotent: true call: microsoft-graph-users-iteminsights.usersinsightsusedgetresource with: $select: tools.$select $expand: tools.$expand outputParameters: - type: object mapping: $.