自定义存储库角色
使用 REST API 与自定义存储库角色交互。
List custom repository roles in an organization
适用于 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."
“List custom repository roles in an organization”的参数
标头 |
---|
名称, 类型, 说明 |
accept string Setting to |
路径参数 |
名称, 类型, 说明 |
organization_id string 必须The unique identifier of the organization. |
“List custom repository roles in an organization”的 HTTP 响应状态代码
状态代码 | 说明 |
---|---|
200 | Response - list of custom role names |
“List custom repository roles in an organization”的示例代码
get /organizations /{organization_id} /custom_roles
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"
}
]
}