ghtier
← All permissions
Enterprise permission·enterprise_copilot_metrics:read

Enterprise Copilot metrics: Read

Tier 3 · Low

Why Tier 3

Reads Copilot usage metrics.

Data plane permissions start at Tier 2. This one is lowered for the reason above.

Target
Enterprise
Plane
DataInsights and billing: Metrics, events, usage, billing and licensing.
Granted by
GitHub App
Available on
Free, Team, Enterprise Cloud, EMU

What it unlocks

6 REST endpoints need this permission. A few of them:

  • GET /enterprises/{enterprise}/copilot/metrics/reports/enterprise-1-day
  • GET /enterprises/{enterprise}/copilot/metrics/reports/enterprise-28-day/latest
  • GET /enterprises/{enterprise}/copilot/metrics/reports/repos-1-day
  • GET /enterprises/{enterprise}/copilot/metrics/reports/user-teams-1-day

Roles that include it

No built-in role includes it. Only tokens, Apps or custom roles can grant it.

Classic scopes that reach it

No classic scope reaches it. Only fine-grained PATs, Apps or GITHUB_TOKEN can grant it.

Attack paths

No attack technique, escalation or incident on ghtier goes through this yet.

GitHub Docs: Enterprise permissions for "Enterprise Copilot metrics"