org_copilot_user_teams_one_day_report
Creates, updates, deletes, gets or lists an org_copilot_user_teams_one_day_report resource.
Overview
| Name | org_copilot_user_teams_one_day_report |
| Type | Resource |
| Id | github.copilot.org_copilot_user_teams_one_day_report |
Fields
The following fields are returned by SELECT queries:
- copilot_organization_user_teams_one_day_report
Response
| Name | Datatype | Description |
|---|---|---|
download_links | array | The URLs to download the Copilot usage metrics report for the enterprise/organization for the specified day. |
report_day | string (date) | The day of the report in YYYY-MM-DD format. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
copilot_organization_user_teams_one_day_report | select | org, 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. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
day | string (date) | The day to request data for, in YYYY-MM-DD format. |
org | string | The organization name. The name is not case sensitive. |
SELECT examples
- copilot_organization_user_teams_one_day_report
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.
SELECT
download_links,
report_day
FROM github.copilot.org_copilot_user_teams_one_day_report
WHERE org = '{{ org }}' -- required
AND day = '{{ day }}' -- required
;