← All permissions
Organization permission·organization_self_hosted_runners:read
Self-hosted runners: Read
Tier 3 · Low
Why Tier 3
Lists self-hosted runners and runner groups.
Management plane permissions start at Tier 1. This one is lowered for the reason above.
- Target
- Organization
- Plane
- ManagementRunners: Self-hosted runners, runner groups, hosted runner images and their networks.
- Granted by
- Fine-grained PAT, GitHub App
- Available on
- Every setup
What it unlocks
10 REST endpoints need this permission. A few of them:
- GET /orgs/{org}/actions/runner-groups
- GET /orgs/{org}/actions/runner-groups/{runner_group_id}
- GET /orgs/{org}/actions/runner-groups/{runner_group_id}/hosted-runners
- GET /orgs/{org}/actions/runner-groups/{runner_group_id}/repositories
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 "Self-hosted runners"