← All permissions
Enterprise permission·enterprise_custom_enterprise_roles:read
Custom enterprise roles: Read
Tier 3 · Low
Why Tier 3
Lists custom enterprise roles and who holds them.
Control plane permissions start at Tier 0. This one is lowered for the reason above.
- Target
- Enterprise
- Plane
- ControlRoles: Custom organization, repository and enterprise roles.
- Granted by
- GitHub App
- Available on
- Enterprise Cloud, EMU
What it unlocks
4 REST endpoints need this permission. A few of them:
- GET /enterprises/{enterprise}/enterprise-roles
- GET /enterprises/{enterprise}/enterprise-roles/{role_id}
- GET /enterprises/{enterprise}/enterprise-roles/{role_id}/teams
- GET /enterprises/{enterprise}/enterprise-roles/{role_id}/users
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 "Custom enterprise roles"