This version of GitHub Enterprise Server was discontinued on 2024-01-04. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise Server. For help with the upgrade, contact GitHub Enterprise support.
Custom Repository Roles
Use the REST API to interact with custom repository roles.
List custom repository roles in an organization
List the custom repository roles available in this organization. In order to see custom repository roles in an organization, the authenticated user must be an organization owner.
To use this endpoint the authenticated user must be an administrator for the organization or of an repository of the organization and must use an access token with admin:org repo
scope.
GitHub Apps must have the organization_custom_roles:read
organization permission to use this endpoint.
For more information on custom repository roles, see "About custom repository roles."
Parameters for "List custom repository roles in an organization"
Name, Type, Description |
---|
accept string Setting to |
Name, Type, Description |
---|
organization_id string RequiredThe unique identifier of the organization. |
HTTP response status codes for "List custom repository roles in an organization"
Status code | Description |
---|---|
200 | Response - list of custom role names |
Code samples for "List custom repository roles in an organization"
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/organizations/ORGANIZATION_ID/custom_roles
Response - list of custom role names
Status: 200
{
"total_count": 2,
"custom_roles": [
{
"id": 8030,
"name": "Developer"
},
{
"id": 8031,
"name": "Designer"
}
]
}