ghtier
← All permissions
Enterprise permission·enterprise_teams:read

Enterprise teams: Read

Tier 3 · Low

Why Tier 3

Lists enterprise teams, their members and organizations.

Control plane permissions start at Tier 0. This one is lowered for the reason above.

Target
Enterprise
Plane
ControlIdentity: Members, teams, SCIM provisioning and the credentials attached to an account.
Granted by
GitHub App
Available on
Enterprise Cloud, EMU, Server

What it unlocks

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

  • GET /enterprises/{enterprise}/members/{username}/teams
  • GET /enterprises/{enterprise}/teams
  • GET /enterprises/{enterprise}/teams/{enterprise-team}/memberships
  • GET /enterprises/{enterprise}/teams/{enterprise-team}/memberships/{username}

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.

Other levels

GitHub Docs: Enterprise permissions for "Enterprise teams"