v56

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

Get Copilot organization user-teams report for a specific day

Use this endpoint to retrieve download links for the Copilot organization user-teams report for a specific day. The report provides user-team join data for Copilot across the organization, 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 organization 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.

Organization owners and authorized users with fine-grained "View Organization Copilot Metrics" permission can retrieve Copilot metrics reports for the organization. OAuth app tokens and personal access tokens (classic) need the read:org scope to use this endpoint.

For more information about organization metrics attribution, see How are metrics attributed across organizations.

get/orgs/{org}/copilot/metrics/reports/user-teams-1-day

Path parameters

orgstring required

The organization name. The name is not case sensitive.

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.