← All permissions
Organization permission·organization_custom_org_roles:read
Custom organization roles: Read
Tier 3 · Low
Why Tier 3
Lists custom organization roles and their permissions.
Control plane permissions start at Tier 0. This one is lowered for the reason above.
- Target
- Organization
- Plane
- ControlRoles: Custom organization, repository and enterprise roles.
- Granted by
- Fine-grained PAT, GitHub App
- Available on
- Every setup
What it unlocks
3 REST endpoints need this permission. A few of them:
- GET /orgs/{org}/organization-fine-grained-permissions
- GET /orgs/{org}/organization-roles
- GET /orgs/{org}/organization-roles/{role_id}
Roles that include it
No built-in role includes it. Only tokens, Apps or custom roles can grant it.
Classic scopes that reach it
- T0admin:orgdocumented
Attack paths
No attack technique, escalation or incident on ghtier goes through this yet.
Other levels
GitHub Docs: Organization permissions for "Custom organization roles"