Skip to main content
We publish frequent updates to our documentation, and translation of this page may still be in progress. For the most current information, please visit the English documentation.

Пользовательские роли репозитория

Используйте REST API для взаимодействия с пользовательскими ролями репозитория.

List custom repository roles in an organization

Works with GitHub Apps

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

Headers
Имя, Type, Описание
acceptstring

Setting to application/vnd.github+json is recommended.

Path parameters
Имя, Type, Описание
organization_idstringRequired

The unique identifier of the organization.

HTTP response status codes

Status codeОписание
200

Response - list of custom role names

Code samples

get/organizations/{organization_id}/custom_roles
curl \ -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" } ] }