Clarify GitHub Actions Role Assignment Examples in Organization Management Docs

[viviarentals]

Code of Conduct

• I have read and agree to the GitHub Docs project's Code of Conduct

What article on docs.github.com is affected?

The examples and context under “Assigning roles using the GitHub API or CLI” section could be enhanced to show how to assign custom roles programmatically during a signup process or through an automation workflow (e.g. via GitHub Actions). Additionally, there could be more clarity on mapping roles for external identity systems like SAML SSO or third-party onboarding flows.

What part(s) of the article would you like to see updated?

We’re building an automated onboarding flow for GitHub org users based on signups from our app, assigning roles like partner-basic or billing-manager. More guidance on doing this via Actions and API would be valuable for org admins using automation for scalable team management.

Additional information

This would help teams automating org management and permissions via CI/CD workflows. We’re currently using GitHub Actions for provisioning org repositories and assigning users, but role assignment isn’t covered clearly in the existing documentation.

[Sharra-writes]

Thanks so much for opening an issue! I'll get this triaged for review