← All permissions
Organization permission·organization_custom_org_roles:write
Custom organization roles: Write
Tier 1 · High
Why Tier 1
Creates and changes custom organization roles. Editing a role that is already assigned changes what every holder can do; assigning roles needs Members: write.
Control plane permissions start at Tier 0. This one is lowered for the reason above.
Context-dependent: the tier shown is the typical case. What the target is used for decides the real one.
- Target
- Organization
- Plane
- ControlRoles: Custom organization, repository and enterprise roles.
- Granted by
- Fine-grained PAT, GitHub App
- Available on
- Enterprise Cloud, EMU, Server
What it unlocks
3 REST endpoints need this permission. A few of them:
- POST /orgs/{org}/organization-roles
- PATCH /orgs/{org}/organization-roles/{role_id}
- DELETE /orgs/{org}/organization-roles/{role_id}
Roles that include it
- T0OwnerThe organization and every repository in 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"