{"id":96113,"date":"2026-05-14T16:06:25","date_gmt":"2026-05-14T23:06:25","guid":{"rendered":"https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api"},"modified":"2026-05-14T16:09:28","modified_gmt":"2026-05-14T23:09:28","slug":"team-level-copilot-usage-metrics-now-available-via-api","status":"publish","type":[3521],"link":"https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api","title":{"rendered":"Team-level Copilot usage metrics now available via API"},"content":{"rendered":"<!DOCTYPE html PUBLIC \"-\/\/W3C\/\/DTD HTML 4.0 Transitional\/\/EN\" \"http:\/\/www.w3.org\/TR\/REC-html40\/loose.dtd\">\n<html><body><p>The <a href=\"https:\/\/docs.github.com\/enterprise-cloud@latest\/rest\/copilot\/copilot-usage-metrics?apiVersion=2026-03-10\">Copilot usage metrics API<\/a> now exposes a new <strong>user-teams<\/strong> report that maps each Copilot-licensed user to the teams they belong to. By joining the user-teams report with the existing per-user usage report, enterprise administrators and organization owners can produce team-level Copilot usage metrics for any team in their organization or enterprise. This includes elements such as active users, completions, chats, as well as breakdowns by language, IDE, feature, and model.<\/p>\n<h3 id=\"how-it-works\" id=\"how-it-works\" ><a class=\"heading-link\" href=\"#how-it-works\">How it works<span class=\"heading-hash pl-2 text-italic text-bold\" aria-hidden=\"true\"><\/span><\/a><\/h3>\n<p>Two new endpoints return signed download URLs to NDJSON reports:<\/p>\n<ul>\n<li><code>GET \/enterprises\/{enterprise}\/copilot\/metrics\/reports\/user-teams-1-day<\/code><\/li>\n<li><code>GET \/orgs\/{org}\/copilot\/metrics\/reports\/user-teams-1-day<\/code><\/li>\n<\/ul>\n<p>Each row in the user-teams report represents a team membership for a given day, including the team&rsquo;s enterprise or organization id, team slug, and the user&rsquo;s ID and login. To produce team-level metrics, join the user-teams report to the per-user usage report on <code>user_id<\/code> and <code>day<\/code>, then aggregate.<\/p>\n<p>This release also introduces step-by-step guidance in <a href=\"https:\/\/docs.github.com\/enterprise-cloud@latest\/copilot\/reference\/copilot-usage-metrics\/team-level-metrics#how-to-construct-team-level-metrics\">the docs<\/a> covering the join, day-level aggregation, and a rolling-window pattern for multi-day reporting.<\/p>\n<h3 id=\"who-can-use-this-feature\" id=\"who-can-use-this-feature\" ><a class=\"heading-link\" href=\"#who-can-use-this-feature\">Who can use this feature<span class=\"heading-hash pl-2 text-italic text-bold\" aria-hidden=\"true\"><\/span><\/a><\/h3>\n<p>These metrics are available through the REST API to enterprise administrators, organization owners, billing managers, and people with an enterprise custom role with the <code>View Enterprise Copilot Metrics<\/code> permission.<\/p>\n<h3 id=\"key-benefits\" id=\"key-benefits\" ><a class=\"heading-link\" href=\"#key-benefits\">Key benefits<span class=\"heading-hash pl-2 text-italic text-bold\" aria-hidden=\"true\"><\/span><\/a><\/h3>\n<ul>\n<li><strong>Slice metrics by team<\/strong>: Pivot Copilot adoption, active users, and code generation activity from org\/enterprise totals down to any organization or enterprise team without building external team attribution.<\/li>\n<li><strong>Identify champions and gaps<\/strong>: See which teams are driving adoption and which need enablement, so you can target campaigns and rollout investments.<\/li>\n<li><strong>Full feature coverage<\/strong>: Team-level breakdowns are available across IDE completions, chat, Copilot CLI, code review, and Copilot cloud agent activity. They can be cut by language, IDE, feature, or model.<\/li>\n<\/ul>\n<h3 id=\"important-notes\" id=\"important-notes\" ><a class=\"heading-link\" href=\"#important-notes\">Important notes<span class=\"heading-hash pl-2 text-italic text-bold\" aria-hidden=\"true\"><\/span><\/a><\/h3>\n<ul>\n<li>User-teams reports are available through the REST API only. There is no dashboard surface for team-level metrics in this release.<\/li>\n<li>Teams with fewer than five Copilot-seated users are excluded from the user-teams report, though their members&rsquo; individual activity remains visible in the per-user usage report.<\/li>\n<li>Users who belong to multiple teams will have their activity counted in each team&rsquo;s aggregate, so team totals cannot be summed to reproduce an organization or enterprise total.<\/li>\n<li>For step-by-step guidance, including the join recipe and rolling-window aggregation, see <a href=\"https:\/\/docs.github.com\/enterprise-cloud@latest\/copilot\/reference\/copilot-usage-metrics\/team-level-metrics\">Team-level Copilot usage metrics<\/a>.<\/li>\n<\/ul>\n<p>Join the discussion within <a href=\"https:\/\/github.com\/orgs\/community\/discussions\/categories\/announcements\">GitHub Community<\/a>.<\/p>\n<\/body><\/html>\n","protected":false},"excerpt":{"rendered":"<p>The Copilot usage metrics API now exposes a new user-teams report that maps each Copilot-licensed user to the teams they belong to. By joining the user-teams report with the existing&hellip;<\/p>\n","protected":false},"author":2106,"featured_media":0,"template":"","meta":{"_gh_post_show_toc":"","_gh_post_is_no_robots":"","_gh_post_is_featured":"","_gh_post_is_excluded":"","_gh_post_is_unlisted":"","_gh_post_related_link_1":"","_gh_post_related_link_2":"","_gh_post_related_link_3":"","_gh_post_sq_img":"","_gh_post_sq_img_id":"","_gh_post_cta_title":"","_gh_post_cta_text":"","_gh_post_cta_link":"","_gh_post_cta_button":"","_gh_post_recirc_hide":"","_gh_post_recirc_col_1":"","_gh_post_recirc_col_2":"","_gh_post_recirc_col_3":"","_gh_post_recirc_col_4":"","_featured_video":"","_gh_post_additional_query_params":"","footnotes":"","_links_to":"","_links_to_target":"","primary_cta":"","primary_cta_url":"","secondary_cta":"","secondary_cta_url":""},"label":[3633,2765,3632],"group":[3851],"coauthors":[3100],"class_list":["post-96113","changelog","type-changelog","status-publish","hentry","changelog-type-new-releases","changelog-label-account-management","changelog-label-copilot","changelog-label-enterprise-management-tools","changelog-group-05-2026"],"yoast_head":"<!-- This site is optimized with the Yoast SEO Premium plugin v27.5 (Yoast SEO v27.5) - https:\/\/yoast.com\/product\/yoast-seo-premium-wordpress\/ -->\n<title>Team-level Copilot usage metrics now available via API - GitHub Changelog<\/title>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\/\" \/>\n<meta property=\"og:locale\" content=\"en_US\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Team-level Copilot usage metrics now available via API \u00b7 GitHub Changelog\" \/>\n<meta property=\"og:description\" content=\"The Copilot usage metrics API now exposes a new user-teams report that maps each Copilot-licensed user to the teams they belong to. By joining the user-teams report with the existing&hellip;\" \/>\n<meta property=\"og:url\" content=\"https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\/\" \/>\n<meta property=\"og:site_name\" content=\"The GitHub Blog\" \/>\n<meta property=\"article:modified_time\" content=\"2026-05-14T23:09:28+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/github.blog\/wp-content\/uploads\/2026\/05\/592661687-01987470-8ae3-4408-8cf8-9648c12e6a11.jpeg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"630\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/png\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:label1\" content=\"Est. reading time\" \/>\n\t<meta name=\"twitter:data1\" content=\"2 minutes\" \/>\n\t<meta name=\"twitter:label2\" content=\"Written by\" \/>\n\t<meta name=\"twitter:data2\" content=\"Allison\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\\\/\\\/schema.org\",\"@graph\":[{\"@type\":\"WebPage\",\"@id\":\"https:\\\/\\\/github.blog\\\/changelog\\\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\\\/\",\"url\":\"https:\\\/\\\/github.blog\\\/changelog\\\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\\\/\",\"name\":\"Team-level Copilot usage metrics now available via API - The GitHub Blog\",\"isPartOf\":{\"@id\":\"https:\\\/\\\/github.blog\\\/#website\"},\"datePublished\":\"2026-05-14T23:06:25+00:00\",\"dateModified\":\"2026-05-14T23:09:28+00:00\",\"breadcrumb\":{\"@id\":\"https:\\\/\\\/github.blog\\\/changelog\\\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\\\/#breadcrumb\"},\"inLanguage\":\"en-US\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\\\/\\\/github.blog\\\/changelog\\\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\\\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\\\/\\\/github.blog\\\/changelog\\\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\\\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Home\",\"item\":\"https:\\\/\\\/github.blog\\\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Changelogs\",\"item\":\"https:\\\/\\\/github.blog\\\/changelog\\\/\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Team-level Copilot usage metrics now available via API\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\\\/\\\/github.blog\\\/#website\",\"url\":\"https:\\\/\\\/github.blog\\\/\",\"name\":\"The GitHub Blog\",\"description\":\"Updates, ideas, and inspiration from GitHub to help developers build and design software.\",\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\\\/\\\/github.blog\\\/?s={search_term_string}\"},\"query-input\":{\"@type\":\"PropertyValueSpecification\",\"valueRequired\":true,\"valueName\":\"search_term_string\"}}],\"inLanguage\":\"en-US\"}]}<\/script>\n<!-- \/ Yoast SEO Premium plugin. -->","yoast_head_json":{"title":"Team-level Copilot usage metrics now available via API - GitHub Changelog","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\/","og_locale":"en_US","og_type":"article","og_title":"Team-level Copilot usage metrics now available via API \u00b7 GitHub Changelog","og_description":"The Copilot usage metrics API now exposes a new user-teams report that maps each Copilot-licensed user to the teams they belong to. By joining the user-teams report with the existing&hellip;","og_url":"https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\/","og_site_name":"The GitHub Blog","article_modified_time":"2026-05-14T23:09:28+00:00","og_image":[{"width":1200,"height":630,"url":"https:\/\/github.blog\/wp-content\/uploads\/2026\/05\/592661687-01987470-8ae3-4408-8cf8-9648c12e6a11.jpeg","type":"image\/png"}],"twitter_card":"summary_large_image","twitter_misc":{"Est. reading time":"2 minutes","Written by":"Allison"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"WebPage","@id":"https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\/","url":"https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\/","name":"Team-level Copilot usage metrics now available via API - The GitHub Blog","isPartOf":{"@id":"https:\/\/github.blog\/#website"},"datePublished":"2026-05-14T23:06:25+00:00","dateModified":"2026-05-14T23:09:28+00:00","breadcrumb":{"@id":"https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\/#breadcrumb"},"inLanguage":"en-US","potentialAction":[{"@type":"ReadAction","target":["https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/github.blog\/changelog\/2026-05-14-team-level-copilot-usage-metrics-now-available-via-api\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https:\/\/github.blog\/"},{"@type":"ListItem","position":2,"name":"Changelogs","item":"https:\/\/github.blog\/changelog\/"},{"@type":"ListItem","position":3,"name":"Team-level Copilot usage metrics now available via API"}]},{"@type":"WebSite","@id":"https:\/\/github.blog\/#website","url":"https:\/\/github.blog\/","name":"The GitHub Blog","description":"Updates, ideas, and inspiration from GitHub to help developers build and design software.","potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/github.blog\/?s={search_term_string}"},"query-input":{"@type":"PropertyValueSpecification","valueRequired":true,"valueName":"search_term_string"}}],"inLanguage":"en-US"}]}},"jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs\/96113","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs"}],"about":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/types\/changelog"}],"author":[{"embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/users\/2106"}],"version-history":[{"count":2,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs\/96113\/revisions"}],"predecessor-version":[{"id":96117,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/changelogs\/96113\/revisions\/96117"}],"wp:attachment":[{"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/media?parent=96113"}],"wp:term":[{"taxonomy":"changelog-type","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/type?post=96113"},{"taxonomy":"changelog-label","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/label?post=96113"},{"taxonomy":"changelog-group","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/group?post=96113"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/github.blog\/wp-json\/wp\/v2\/coauthors?post=96113"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}