← All permissions
User permission·emails:write
Email addresses: Write
Tier 2 · Medium
Why Tier 2
Adds and removes email addresses and changes their visibility.
Control plane permissions start at Tier 0. This one is lowered for the reason above.
- Target
- User
- Plane
- ControlIdentity: Members, teams, SCIM provisioning and the credentials attached to an account.
- Granted by
- Fine-grained PAT, GitHub App
- Available on
- Every setup
What it unlocks
3 REST endpoints need this permission. A few of them:
- PATCH /user/email/visibility
- POST /user/emails
- DELETE /user/emails
Roles that include it
No built-in role includes it. Only tokens, Apps or custom roles can grant it.
Classic scopes that reach it
- T2userdocumented
Attack paths
No attack technique, escalation or incident on ghtier goes through this yet.