Skip to main content

Enterprise Server 3.21 в настоящее время доступен в качестве кандидата на выпуск.

REST API теперь версия. Дополнительные сведения см. в разделе "О управлении версиями API".

Конечные точки REST API для организаций корпоративных групп

Используйте REST API для создания и управления назначениями организации для корпоративных команд в GitHub предприятии.

Об организациях корпоративной команды

Примечание.

В настоящее время эти конечные точки находятся в Публичный предварительный просмотр и подвергаются изменению.

Эта документация по API предназначена для предприятий на GitHub Enterprise Cloud.

Если ваше предприятие — Copilot Business for non-GHE, обратитесь к ссылке документации по началу доступа, которая ранее была предоставлена вам.

Эти конечные точки доступны только для прошедших проверку подлинности членов предприятия команды предприятия с классической версией personal access tokens с read:enterprise областью GET действия API и admin:enterprise для других API.

Эти конечные точки несовместимы с маркерами доступа к приложениям fine-grained personal access tokens или GitHub App.

GitHub создает команду предприятия slug из команды name и добавляет ent: префикс.

Get organization assignments

Get all organizations assigned to an enterprise team

Fine-grained access tokens for "Get organization assignments"

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)

Параметры для «Get organization assignments»

Заголовки
Имя., Тип, Description
accept string

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

Параметры пути
Имя., Тип, Description
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.

Параметры запроса
Имя., Тип, Description
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 "Get organization assignments"

Status codeDescription
200

An array of organizations the team is assigned to

Code samples for "Get organization assignments"

Request example

get/enterprises/{enterprise}/teams/{enterprise-team}/organizations
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/organizations

An array of organizations the team is assigned to

Status: 200
{ "login": "github", "id": 1, "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=", "url": "https://HOSTNAME/orgs/github", "repos_url": "https://HOSTNAME/orgs/github/repos", "events_url": "https://HOSTNAME/orgs/github/events", "hooks_url": "https://HOSTNAME/orgs/github/hooks", "issues_url": "https://HOSTNAME/orgs/github/issues", "members_url": "https://HOSTNAME/orgs/github/members{/member}", "public_members_url": "https://HOSTNAME/orgs/github/public_members{/member}", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "description": "A great organization" }

Add organization assignments

Assign an enterprise team to multiple organizations.

Fine-grained access tokens for "Add organization assignments"

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 organization assignments»

Заголовки
Имя., Тип, Description
accept string

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

Параметры пути
Имя., Тип, Description
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.

Параметры запроса
Имя., Тип, Description
organization_slugs array of strings Обязательное поле

Organization slug to assign the team to.

HTTP response status codes for "Add organization assignments"

Status codeDescription
200

Successfully assigned the enterprise team to organizations.

Code samples for "Add organization assignments"

Request example

post/enterprises/{enterprise}/teams/{enterprise-team}/organizations/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/organizations/add \ -d '{"organization_slugs":["github"]}'

Successfully assigned the enterprise team to organizations.

Status: 200
[ { "login": "github", "id": 1, "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=", "url": "https://HOSTNAME/orgs/github", "repos_url": "https://HOSTNAME/orgs/github/repos", "events_url": "https://HOSTNAME/orgs/github/events", "hooks_url": "https://HOSTNAME/orgs/github/hooks", "issues_url": "https://HOSTNAME/orgs/github/issues", "members_url": "https://HOSTNAME/orgs/github/members{/member}", "public_members_url": "https://HOSTNAME/orgs/github/public_members{/member}", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "description": "A great organization" } ]

Remove organization assignments

Unassign an enterprise team from multiple organizations.

Fine-grained access tokens for "Remove organization assignments"

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 organization assignments»

Заголовки
Имя., Тип, Description
accept string

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

Параметры пути
Имя., Тип, Description
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.

Параметры запроса
Имя., Тип, Description
organization_slugs array of strings Обязательное поле

Organization slug to unassign the team from.

HTTP response status codes for "Remove organization assignments"

Status codeDescription
204

Successfully unassigned the enterprise team from organizations.

Code samples for "Remove organization assignments"

Request example

post/enterprises/{enterprise}/teams/{enterprise-team}/organizations/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/organizations/remove \ -d '{"organization_slugs":["github"]}'

Successfully unassigned the enterprise team from organizations.

Status: 204

Get organization assignment

Check if an enterprise team is assigned to an organization

Fine-grained access tokens for "Get organization assignment"

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)

Параметры для «Get organization assignment»

Заголовки
Имя., Тип, Description
accept string

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

Параметры пути
Имя., Тип, Description
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.

org string Обязательное поле

The organization name. The name is not case sensitive.

HTTP response status codes for "Get organization assignment"

Status codeDescription
200

The team is assigned to the organization

404

The team is not assigned to the organization

Code samples for "Get organization assignment"

Request example

get/enterprises/{enterprise}/teams/{enterprise-team}/organizations/{org}
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/organizations/ORG

The team is assigned to the organization

Status: 200
{ "login": "github", "id": 1, "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=", "url": "https://HOSTNAME/orgs/github", "repos_url": "https://HOSTNAME/orgs/github/repos", "events_url": "https://HOSTNAME/orgs/github/events", "hooks_url": "https://HOSTNAME/orgs/github/hooks", "issues_url": "https://HOSTNAME/orgs/github/issues", "members_url": "https://HOSTNAME/orgs/github/members{/member}", "public_members_url": "https://HOSTNAME/orgs/github/public_members{/member}", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "description": "A great organization" }

Add an organization assignment

Assign an enterprise team to an organization.

Fine-grained access tokens for "Add an organization assignment"

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 an organization assignment»

Заголовки
Имя., Тип, Description
accept string

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

Параметры пути
Имя., Тип, Description
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.

org string Обязательное поле

The organization name. The name is not case sensitive.

HTTP response status codes for "Add an organization assignment"

Status codeDescription
201

Successfully assigned the enterprise team to the organization.

Code samples for "Add an organization assignment"

Request example

put/enterprises/{enterprise}/teams/{enterprise-team}/organizations/{org}
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/organizations/ORG

Successfully assigned the enterprise team to the organization.

Status: 201
{ "login": "github", "id": 1, "node_id": "MDEyOk9yZ2FuaXphdGlvbjE=", "url": "https://HOSTNAME/orgs/github", "repos_url": "https://HOSTNAME/orgs/github/repos", "events_url": "https://HOSTNAME/orgs/github/events", "hooks_url": "https://HOSTNAME/orgs/github/hooks", "issues_url": "https://HOSTNAME/orgs/github/issues", "members_url": "https://HOSTNAME/orgs/github/members{/member}", "public_members_url": "https://HOSTNAME/orgs/github/public_members{/member}", "avatar_url": "https://github.com/images/error/octocat_happy.gif", "description": "A great organization" }

Delete an organization assignment

Unassign an enterprise team from an organization.

Fine-grained access tokens for "Delete an organization assignment"

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)

Параметры для «Delete an organization assignment»

Заголовки
Имя., Тип, Description
accept string

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

Параметры пути
Имя., Тип, Description
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.

org string Обязательное поле

The organization name. The name is not case sensitive.

HTTP response status codes for "Delete an organization assignment"

Status codeDescription
204

Successfully unassigned the enterprise team from the organization.

Code samples for "Delete an organization assignment"

Request example

delete/enterprises/{enterprise}/teams/{enterprise-team}/organizations/{org}
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/organizations/ORG

Successfully unassigned the enterprise team from the organization.

Status: 204