🚀 Copilot: Migrate to the New GitHub Copilot Usage Metrics API

[Chris-Lee-Ca]

Workspace

copilot

🔖 Feature description

The Backstage Copilot plugin should be updated to fetch metrics from the new GitHub Copilot Usage Metrics API instead of the legacy Copilot Metrics API.

Specifically, the plugin should replace usage of the legacy endpoint with the new API so that Copilot usage and metrics continue to function without interruption after the legacy API is deprecated.

🎤 Context

The Copilot plugin currently relies on the Copilot Metrics API to retrieve usage metrics:

• Legacy API: https://docs.github.com/enterprise-cloud@latest/rest/copilot/copilot-metrics?apiVersion=2022-11-28

According to GitHub’s announcement, this API will be sunset on April 2, 2026

GitHub has introduced a replacement endpoint:

• New API: https://docs.github.com/en/enterprise-cloud@latest/rest/copilot/copilot-usage-metrics?apiVersion=2022-11-28

Once the legacy API is retired, the Copilot plugin will no longer be able to fetch metrics unless it is migrated to the new endpoint

✌️ Possible Implementation

No response

👀 Have you spent some time to check if this feature request has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

Are you willing to submit PR?

None

[awanlin]

Hi @Chris-Lee-Ca, I'm confused, isn't this the opposite of what we had to do a year ago? #2828

[Chris-Lee-Ca]

It is different. The new endpoint is under the /metrics/reports path, not /usage

[gaelgoth]

Sharing the GitHub announcement for a bit of extra context: https://github.blog/changelog/2026-01-29-closing-down-notice-of-legacy-copilot-metrics-apis/

Using the new API will also help for #3978

[henrikedegrd]

I am in the makes of adding the new usage-endpoints into this plugin.

Will probably have a PR ready in a week. Currently doing a lot of analysis of the new json-files provided.

It will coexist with the old data. treating that as "legacy" for historical views.
But the new usage brings a better view of how it is used.

[awanlin]

Thanks for clarifying @Chris-Lee-Ca, these URLs all look so similar to me ♾️

Glad to hear your are working on it @henrikedegrd 🚀