REST API はバージョン化されました。詳細については、「API のバージョン管理について」を参照してください。

Enterprise チームメンバーシップの REST API エンドポイント

REST API を使用して、 GitHub 企業のエンタープライズチームのメンバーシップを作成および管理します。

Enterprise チームメンバーについて

メモ

現在、このエンドポイントはパブリックプレビュー段階であり、変更される可能性があります。

この API ドキュメントは、GitHub Enterprise Cloud 上の Enterprise を対象としています。

Enterprise が GHE を利用していない Copilot Business である場合は、以前に共有された早期アクセス用ドキュメントリンクを参照してください。

これらのエンドポイントは、GET APIは read:enterprise スコープ、その他の APIは admin:enterprise であり、クラシック personal access tokens を利用する Enterprise チームの Enterprise に属する認証済みメンバーのみが使用できます。

これらのエンドポイントは、fine-grained personal access tokens または GitHub App アクセストークンと互換性がありません。

GitHub により、チーム name から Enterprise チームの slug が生成され、ent: プレフィックスが追加されます。

List members in an enterprise team

Lists all team members in an enterprise team.

Fine-grained access tokens for "List members in an enterprise team"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (read)

"List members in an enterprise team" のパラメーター

ヘッダー
名前, タイプ, 説明
`accept` string Setting to `application/vnd.github+json` is recommended.

パスパラメーター
名前, タイプ, 説明
`enterprise` string 必須 The slug version of the enterprise name.
`enterprise-team` string 必須 The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.

クエリパラメーター
名前, タイプ, 説明
`per_page` integer The number of results per page (max 100). For more information, see "Using pagination in the REST API." デフォルト: `30`
`page` integer The page number of the results to fetch. For more information, see "Using pagination in the REST API." デフォルト: `1`

HTTP response status codes for "List members in an enterprise team"

Status code	説明
`200`	OK

Code samples for "List members in an enterprise team"

Request example

get/enterprises/{enterprise}/teams/{enterprise-team}/memberships

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/memberships

Response

Status: 200

[
  {
    "login": "octocat",
    "id": 1,
    "node_id": "MDQ6VXNlcjE=",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://HOSTNAME/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://HOSTNAME/users/octocat/followers",
    "following_url": "https://HOSTNAME/users/octocat/following{/other_user}",
    "gists_url": "https://HOSTNAME/users/octocat/gists{/gist_id}",
    "starred_url": "https://HOSTNAME/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://HOSTNAME/users/octocat/subscriptions",
    "organizations_url": "https://HOSTNAME/users/octocat/orgs",
    "repos_url": "https://HOSTNAME/users/octocat/repos",
    "events_url": "https://HOSTNAME/users/octocat/events{/privacy}",
    "received_events_url": "https://HOSTNAME/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
]

Bulk add team members

Add multiple team members to an enterprise team.

Fine-grained access tokens for "Bulk add team members"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (write)

"Bulk add team members" のパラメーター

ヘッダー
名前, タイプ, 説明
`accept` string Setting to `application/vnd.github+json` is recommended.

パスパラメーター
名前, タイプ, 説明
`enterprise` string 必須 The slug version of the enterprise name.
`enterprise-team` string 必須 The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.

ボディパラメータ
名前, タイプ, 説明
`usernames` array of strings 必須 The GitHub user handles to add to the team.

HTTP response status codes for "Bulk add team members"

Status code	説明
`200`	Successfully added team members.

Code samples for "Bulk add team members"

Request example

post/enterprises/{enterprise}/teams/{enterprise-team}/memberships/add

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/memberships/add \
  -d '{"usernames":["monalisa","octocat"]}'

Successfully added team members.

Status: 200

[
  {
    "login": "octocat",
    "id": 1,
    "node_id": "MDQ6VXNlcjE=",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://HOSTNAME/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://HOSTNAME/users/octocat/followers",
    "following_url": "https://HOSTNAME/users/octocat/following{/other_user}",
    "gists_url": "https://HOSTNAME/users/octocat/gists{/gist_id}",
    "starred_url": "https://HOSTNAME/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://HOSTNAME/users/octocat/subscriptions",
    "organizations_url": "https://HOSTNAME/users/octocat/orgs",
    "repos_url": "https://HOSTNAME/users/octocat/repos",
    "events_url": "https://HOSTNAME/users/octocat/events{/privacy}",
    "received_events_url": "https://HOSTNAME/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
]

Bulk remove team members

Remove multiple team members from an enterprise team.

Fine-grained access tokens for "Bulk remove team members"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (write)

"Bulk remove team members" のパラメーター

ヘッダー
名前, タイプ, 説明
`accept` string Setting to `application/vnd.github+json` is recommended.

パスパラメーター
名前, タイプ, 説明
`enterprise` string 必須 The slug version of the enterprise name.
`enterprise-team` string 必須 The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.

ボディパラメータ
名前, タイプ, 説明
`usernames` array of strings 必須 The GitHub user handles to be removed from the team.

HTTP response status codes for "Bulk remove team members"

Status code	説明
`200`	Successfully removed team members.

Code samples for "Bulk remove team members"

Request example

post/enterprises/{enterprise}/teams/{enterprise-team}/memberships/remove

curl -L \
  -X POST \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/memberships/remove \
  -d '{"usernames":["monalisa","octocat"]}'

Successfully removed team members.

Status: 200

[
  {
    "login": "octocat",
    "id": 1,
    "node_id": "MDQ6VXNlcjE=",
    "avatar_url": "https://github.com/images/error/octocat_happy.gif",
    "gravatar_id": "",
    "url": "https://HOSTNAME/users/octocat",
    "html_url": "https://github.com/octocat",
    "followers_url": "https://HOSTNAME/users/octocat/followers",
    "following_url": "https://HOSTNAME/users/octocat/following{/other_user}",
    "gists_url": "https://HOSTNAME/users/octocat/gists{/gist_id}",
    "starred_url": "https://HOSTNAME/users/octocat/starred{/owner}{/repo}",
    "subscriptions_url": "https://HOSTNAME/users/octocat/subscriptions",
    "organizations_url": "https://HOSTNAME/users/octocat/orgs",
    "repos_url": "https://HOSTNAME/users/octocat/repos",
    "events_url": "https://HOSTNAME/users/octocat/events{/privacy}",
    "received_events_url": "https://HOSTNAME/users/octocat/received_events",
    "type": "User",
    "site_admin": false
  }
]

Add team member

Add a team member to an enterprise team.

Fine-grained access tokens for "Add team member"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (write)

"Add team member" のパラメーター

ヘッダー
名前, タイプ, 説明
`accept` string Setting to `application/vnd.github+json` is recommended.

パスパラメーター
名前, タイプ, 説明
`enterprise` string 必須 The slug version of the enterprise name.
`enterprise-team` string 必須 The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.
`username` string 必須 The handle for the GitHub user account.

HTTP response status codes for "Add team member"

Status code	説明
`201`	Successfully added team member

Code samples for "Add team member"

Request example

put/enterprises/{enterprise}/teams/{enterprise-team}/memberships/{username}

curl -L \
  -X PUT \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/memberships/USERNAME

Successfully added team member

Status: 201

{
  "login": "octocat",
  "id": 1,
  "node_id": "MDQ6VXNlcjE=",
  "avatar_url": "https://github.com/images/error/octocat_happy.gif",
  "gravatar_id": "",
  "url": "https://HOSTNAME/users/octocat",
  "html_url": "https://github.com/octocat",
  "followers_url": "https://HOSTNAME/users/octocat/followers",
  "following_url": "https://HOSTNAME/users/octocat/following{/other_user}",
  "gists_url": "https://HOSTNAME/users/octocat/gists{/gist_id}",
  "starred_url": "https://HOSTNAME/users/octocat/starred{/owner}{/repo}",
  "subscriptions_url": "https://HOSTNAME/users/octocat/subscriptions",
  "organizations_url": "https://HOSTNAME/users/octocat/orgs",
  "repos_url": "https://HOSTNAME/users/octocat/repos",
  "events_url": "https://HOSTNAME/users/octocat/events{/privacy}",
  "received_events_url": "https://HOSTNAME/users/octocat/received_events",
  "type": "User",
  "site_admin": false
}

Remove team membership

Remove membership of a specific user from a particular team in an enterprise.

Fine-grained access tokens for "Remove team membership"

This endpoint works with the following fine-grained token types:

The fine-grained token must have the following permission set:

"Enterprise teams" enterprise permissions (write)

"Remove team membership" のパラメーター

ヘッダー
名前, タイプ, 説明
`accept` string Setting to `application/vnd.github+json` is recommended.

パスパラメーター
名前, タイプ, 説明
`enterprise` string 必須 The slug version of the enterprise name.
`enterprise-team` string 必須 The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.
`username` string 必須 The handle for the GitHub user account.

HTTP response status codes for "Remove team membership"

Status code	説明
`204`	No Content
`403`	Forbidden

Code samples for "Remove team membership"

Request example

delete/enterprises/{enterprise}/teams/{enterprise-team}/memberships/{username}

curl -L \
  -X DELETE \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  http(s)://HOSTNAME/api/v3/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/memberships/USERNAME

Response

Status: 204

Enterprise チーム メンバーシップの REST API エンドポイント

Request example

Response

Request example

Successfully added team members.

Request example

Successfully removed team members.

Request example

Successfully added team member

Request example

Response

Enterprise チームメンバーシップの REST API エンドポイント