v56

latestOpenAPI 3.0.3MITraw.githubusercontent.com2026-08-011,4581,08113.3 MB
copilot

Get Copilot enterprise user-teams report for a specific day

Use this endpoint to retrieve download links for the Copilot enterprise user-teams report for a specific day. The report provides user-team join data for Copilot across the enterprise, with one entry per user-team pair.

The report contains user-team membership data for the specified day, enabling consumers to join with the existing enterprise user reports to compute team-level usage metrics. Reports are generated daily and made available for download through signed URLs with a limited expiration time.

The response includes download links to the report files, along with the specific date of the report. The report covers a complete day for which data has been processed.

Enterprise owners, billing managers, and authorized users with fine-grained "View Enterprise Copilot Metrics" permission can retrieve Copilot metrics reports for the enterprise. OAuth app tokens and personal access tokens (classic) need either the manage_billing:copilot or read:enterprise scopes to use this endpoint.

get/enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day

Path parameters

enterprisestring required

The slug version of the enterprise name.

Query parameters

daystring date required
Example:2025-10-13

The day to request data for, in YYYY-MM-DD format.

Response

Response

download_linksstring[] required

The URLs to download the Copilot usage metrics report for the enterprise/organization for the specified day.

report_daystring date required

The day of the report in YYYY-MM-DD format.