Microsoft Graph Reports is the reporting surface of Microsoft 365 exposed via Microsoft Graph, enabling administrators to programmatically retrieve usage, adoption, and certain identity and print analytics across their tenant.
openapi: 3.1.0
info:
title: Microsoft Graph Reports
description: Needs a description.
paths:
/copilot/reports:
description: >-
Provides operations to manage the reports property of the
microsoft.graph.copilotRoot entity.
get:
tags:
- copilot.copilotReportRoot
summary: Microsoft Graph Get reports from copilot
operationId: copilot.GetReports
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.copilotReportRoot'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/deviceManagement/reports:
description: >-
Provides operations to manage the reports property of the
microsoft.graph.deviceManagement entity.
get:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Get reports from deviceManagement
operationId: deviceManagement.GetReports
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.deviceManagementReports'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Update the navigation property reports in deviceManagement
operationId: deviceManagement.UpdateReports
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.deviceManagementReports'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.deviceManagementReports'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Delete navigation property reports for deviceManagement
operationId: deviceManagement.DeleteReports
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/deviceManagement/reports/exportJobs:
description: >-
Provides operations to manage the exportJobs property of the
microsoft.graph.deviceManagementReports entity.
get:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Get exportJobs from deviceManagement
description: Entity representing a job to export a report.
operationId: deviceManagement.reports.ListExportJobs
parameters:
- $ref: '#/components/parameters/top'
- $ref: '#/components/parameters/skip'
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
- $ref: '#/components/parameters/count'
- name: $orderby
in: query
description: Order items by property values
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
$ref: >-
#/components/responses/microsoft.graph.deviceManagementExportJobCollectionResponse
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-pageable:
nextLinkName: '@odata.nextLink'
operationName: listMore
x-ms-docs-operation-type: operation
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Create new navigation property to exportJobs for deviceManagement
operationId: deviceManagement.reports.CreateExportJobs
requestBody:
description: New navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.deviceManagementExportJob'
required: true
responses:
2XX:
description: Created navigation property.
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.deviceManagementExportJob'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
/deviceManagement/reports/exportJobs/{deviceManagementExportJob-id}:
description: >-
Provides operations to manage the exportJobs property of the
microsoft.graph.deviceManagementReports entity.
get:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Get exportJobs from deviceManagement
description: Entity representing a job to export a report.
operationId: deviceManagement.reports.GetExportJobs
parameters:
- name: $select
in: query
description: Select properties to be returned
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
- name: $expand
in: query
description: Expand related entities
style: form
explode: false
schema:
uniqueItems: true
type: array
items:
type: string
responses:
2XX:
description: Retrieved navigation property
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.deviceManagementExportJob'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
patch:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Update the navigation property exportJobs in deviceManagement
operationId: deviceManagement.reports.UpdateExportJobs
requestBody:
description: New navigation property values
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.deviceManagementExportJob'
required: true
responses:
2XX:
description: Success
content:
application/json:
schema:
$ref: '#/components/schemas/microsoft.graph.deviceManagementExportJob'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
delete:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Delete navigation property exportJobs for deviceManagement
operationId: deviceManagement.reports.DeleteExportJobs
parameters:
- name: If-Match
in: header
description: ETag
schema:
type: string
responses:
'204':
description: Success
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: operation
parameters:
- name: deviceManagementExportJob-id
in: path
description: The unique identifier of deviceManagementExportJob
required: true
schema:
type: string
x-ms-docs-key-type: deviceManagementExportJob
/deviceManagement/reports/exportJobs/$count:
description: Provides operations to count the resources in the collection.
get:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Get the number of the resource
operationId: deviceManagement.reports.exportJobs.GetCount-5277
parameters:
- $ref: '#/components/parameters/search'
- $ref: '#/components/parameters/filter'
responses:
2XX:
$ref: '#/components/responses/ODataCountResponse'
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
/deviceManagement/reports/getCachedReport:
description: Provides operations to call the getCachedReport method.
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Invoke action getCachedReport
operationId: deviceManagement.reports.getCachedReport
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
id:
type: string
nullable: true
select:
type: array
items:
type: string
nullable: true
groupBy:
type: array
items:
type: string
nullable: true
orderBy:
type: array
items:
type: string
nullable: true
search:
type: string
nullable: true
skip:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
top:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/octet-stream:
schema:
type: object
properties:
value:
type: string
format: base64url
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/deviceManagement/reports/getCompliancePolicyNonComplianceReport:
description: >-
Provides operations to call the getCompliancePolicyNonComplianceReport
method.
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Invoke action getCompliancePolicyNonComplianceReport
operationId: deviceManagement.reports.getCompliancePolicyNonComplianceReport
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
select:
type: array
items:
type: string
nullable: true
groupBy:
type: array
items:
type: string
nullable: true
orderBy:
type: array
items:
type: string
nullable: true
search:
type: string
nullable: true
skip:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
top:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
sessionId:
type: string
nullable: true
filter:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/octet-stream:
schema:
type: object
properties:
value:
type: string
format: base64url
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/deviceManagement/reports/getCompliancePolicyNonComplianceSummaryReport:
description: >-
Provides operations to call the
getCompliancePolicyNonComplianceSummaryReport method.
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Invoke action getCompliancePolicyNonComplianceSummaryReport
operationId: deviceManagement.reports.getCompliancePolicyNonComplianceSummaryReport
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
select:
type: array
items:
type: string
nullable: true
groupBy:
type: array
items:
type: string
nullable: true
orderBy:
type: array
items:
type: string
nullable: true
search:
type: string
nullable: true
skip:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
top:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
sessionId:
type: string
nullable: true
filter:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/octet-stream:
schema:
type: object
properties:
value:
type: string
format: base64url
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/deviceManagement/reports/getComplianceSettingNonComplianceReport:
description: >-
Provides operations to call the getComplianceSettingNonComplianceReport
method.
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Invoke action getComplianceSettingNonComplianceReport
operationId: deviceManagement.reports.getComplianceSettingNonComplianceReport
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
select:
type: array
items:
type: string
nullable: true
groupBy:
type: array
items:
type: string
nullable: true
orderBy:
type: array
items:
type: string
nullable: true
search:
type: string
nullable: true
skip:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
top:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
sessionId:
type: string
nullable: true
filter:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/octet-stream:
schema:
type: object
properties:
value:
type: string
format: base64url
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/deviceManagement/reports/getConfigurationPolicyNonComplianceReport:
description: >-
Provides operations to call the getConfigurationPolicyNonComplianceReport
method.
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Invoke action getConfigurationPolicyNonComplianceReport
operationId: deviceManagement.reports.getConfigurationPolicyNonComplianceReport
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
select:
type: array
items:
type: string
nullable: true
groupBy:
type: array
items:
type: string
nullable: true
orderBy:
type: array
items:
type: string
nullable: true
search:
type: string
nullable: true
skip:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
top:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
sessionId:
type: string
nullable: true
filter:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/octet-stream:
schema:
type: object
properties:
value:
type: string
format: base64url
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/deviceManagement/reports/getConfigurationPolicyNonComplianceSummaryReport:
description: >-
Provides operations to call the
getConfigurationPolicyNonComplianceSummaryReport method.
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Invoke action getConfigurationPolicyNonComplianceSummaryReport
operationId: >-
deviceManagement.reports.getConfigurationPolicyNonComplianceSummaryReport
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
select:
type: array
items:
type: string
nullable: true
groupBy:
type: array
items:
type: string
nullable: true
orderBy:
type: array
items:
type: string
nullable: true
search:
type: string
nullable: true
skip:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
top:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
sessionId:
type: string
nullable: true
filter:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/octet-stream:
schema:
type: object
properties:
value:
type: string
format: base64url
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/deviceManagement/reports/getConfigurationSettingNonComplianceReport:
description: >-
Provides operations to call the getConfigurationSettingNonComplianceReport
method.
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Invoke action getConfigurationSettingNonComplianceReport
operationId: deviceManagement.reports.getConfigurationSettingNonComplianceReport
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
select:
type: array
items:
type: string
nullable: true
groupBy:
type: array
items:
type: string
nullable: true
orderBy:
type: array
items:
type: string
nullable: true
search:
type: string
nullable: true
skip:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
top:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
sessionId:
type: string
nullable: true
filter:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/octet-stream:
schema:
type: object
properties:
value:
type: string
format: base64url
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/deviceManagement/reports/getDeviceManagementIntentPerSettingContributingProfiles:
description: >-
Provides operations to call the
getDeviceManagementIntentPerSettingContributingProfiles method.
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Invoke action getDeviceManagementIntentPerSettingContributingProfiles
operationId: >-
deviceManagement.reports.getDeviceManagementIntentPerSettingContributingProfiles
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
select:
type: array
items:
type: string
nullable: true
groupBy:
type: array
items:
type: string
nullable: true
orderBy:
type: array
items:
type: string
nullable: true
search:
type: string
nullable: true
skip:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
top:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
sessionId:
type: string
nullable: true
filter:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/octet-stream:
schema:
type: object
properties:
value:
type: string
format: base64url
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/deviceManagement/reports/getDeviceManagementIntentSettingsReport:
description: >-
Provides operations to call the getDeviceManagementIntentSettingsReport
method.
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Invoke action getDeviceManagementIntentSettingsReport
operationId: deviceManagement.reports.getDeviceManagementIntentSettingsReport
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
select:
type: array
items:
type: string
nullable: true
groupBy:
type: array
items:
type: string
nullable: true
orderBy:
type: array
items:
type: string
nullable: true
search:
type: string
nullable: true
skip:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
top:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
sessionId:
type: string
nullable: true
filter:
type: string
nullable: true
required: true
responses:
2XX:
description: Success
content:
application/octet-stream:
schema:
type: object
properties:
value:
type: string
format: base64url
nullable: true
4XX:
$ref: '#/components/responses/error'
5XX:
$ref: '#/components/responses/error'
x-ms-docs-operation-type: action
/deviceManagement/reports/getDeviceNonComplianceReport:
description: Provides operations to call the getDeviceNonComplianceReport method.
post:
tags:
- deviceManagement.deviceManagementReports
summary: Microsoft Graph Invoke action getDeviceNonComplianceReport
operationId: deviceManagement.reports.getDeviceNonComplianceReport
requestBody:
description: Action parameters
content:
application/json:
schema:
type: object
properties:
name:
type: string
nullable: true
select:
type: array
items:
type: string
nullable: true
groupBy:
type: array
items:
type: string
nullable: true
orderBy:
type: array
items:
type: string
nullable: true
search:
type: string
nullable: true
skip:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
top:
maximum: 2147483647
minimum: -2147483648
type: number
format: int32
nullable: true
sessionId:
type: string
nullable: true
filter:
type: string
# --- truncated at 32 KB (350 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/microsoft-graph/refs/heads/main/openapi/reports-openapi-original.yml