List custom repository roles in an organization

GET

/orgs/{org}/custom-repository-roles

List the custom repository roles available in this organization. For more information on custom repository roles, see "About custom repository roles."

The authenticated user must be an administrator of the organization or of a repository of the organization to use this endpoint.

OAuth app tokens and personal access tokens (classic) need the admin:org or repo scope to use this endpoint.

リクエストパラメータ

パスパラメータ

レスポンス

🟢200OK

application/json

Response - list of custom role names

ボディapplication/json

リクエストExample

Shell

JavaScript

Java

Swift

curl --location 'https://service1.exmaple.com/orgs//custom-repository-roles'

レスポンスExample

{
    "total_count": 2,
    "custom_roles": [
        {
            "id": 8030,
            "name": "Security Engineer",
            "description": "Able to contribute code and maintain the security pipeline",
            "base_role": "maintain",
            "permissions": [
                "delete_alerts_code_scanning"
            ],
            "organization": {
                "login": "github",
                "id": 9919,
                "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=",
                "avatar_url": "https://avatars.githubusercontent.com/u/9919?v=4",
                "gravatar_id": "",
                "url": "https://api.github.com/users/github",
                "html_url": "https://github.com/github",
                "followers_url": "https://api.github.com/users/github/followers",
                "following_url": "https://api.github.com/users/github/following{/other_user}",
                "gists_url": "https://api.github.com/users/github/gists{/gist_id}",
                "starred_url": "https://api.github.com/users/github/starred{/owner}{/repo}",
                "subscriptions_url": "https://api.github.com/users/github/subscriptions",
                "organizations_url": "https://api.github.com/users/github/orgs",
                "repos_url": "https://api.github.com/users/github/repos",
                "events_url": "https://api.github.com/users/github/events{/privacy}",
                "received_events_url": "https://api.github.com/users/github/received_events",
                "type": "Organization",
                "site_admin": false
            },
            "created_at": "2022-07-04T22:19:11Z",
            "updated_at": "2022-07-04T22:20:11Z"
        },
        {
            "id": 8031,
            "name": "Community manager",
            "description": "Able to handle all the community interactions without being able to contribute code",
            "base_role": "read",
            "permissions": [
                "mark_as_duplicate",
                "manage_settings_pages",
                "manage_settings_wiki",
                "set_social_preview",
                "edit_repo_metadata",
                "toggle_discussion_comment_minimize"
            ],
            "organization": {
                "login": "github",
                "id": 9919,
                "node_id": "MDEyOk9yZ2FuaXphdGlvbjk5MTk=",
                "avatar_url": "https://avatars.githubusercontent.com/u/9919?v=4",
                "gravatar_id": "",
                "url": "https://api.github.com/users/github",
                "html_url": "https://github.com/github",
                "followers_url": "https://api.github.com/users/github/followers",
                "following_url": "https://api.github.com/users/github/following{/other_user}",
                "gists_url": "https://api.github.com/users/github/gists{/gist_id}",
                "starred_url": "https://api.github.com/users/github/starred{/owner}{/repo}",
                "subscriptions_url": "https://api.github.com/users/github/subscriptions",
                "organizations_url": "https://api.github.com/users/github/orgs",
                "repos_url": "https://api.github.com/users/github/repos",
                "events_url": "https://api.github.com/users/github/events{/privacy}",
                "received_events_url": "https://api.github.com/users/github/received_events",
                "type": "Organization",
                "site_admin": false
            },
            "created_at": "2022-07-05T12:01:11Z",
            "updated_at": "2022-07-05T12:20:11Z"
        }
    ]
}

更新日時 2025-06-12 06:47:19

Get the audit log for an organization

Create a custom repository role