{"meta":{"title":"엔터프라이즈 팀 조직을 위한 REST API 엔드포인트","intro":"REST API를 사용하여 GitHub 엔터프라이즈에서 엔터프라이즈 팀에 대한 조직 할당을 만들고 관리합니다.","product":"REST API","breadcrumbs":[{"href":"/ko/rest","title":"REST API"},{"href":"/ko/rest/enterprise-teams","title":"엔터프라이즈 팀"},{"href":"/ko/rest/enterprise-teams/enterprise-team-organizations","title":"엔터프라이즈 팀 조직"}],"documentType":"article"},"body":"# 엔터프라이즈 팀 조직을 위한 REST API 엔드포인트\n\nREST API를 사용하여 GitHub 엔터프라이즈에서 엔터프라이즈 팀에 대한 조직 할당을 만들고 관리합니다.\n\n## 엔터프라이즈 팀 조직 정보\n\n> \\[!NOTE]\n> 이 엔드포인트는 현재 공개 미리 보기 버전이며 변경될 수 있습니다.\n>\n> 이 API 문서는 GitHub Enterprise Cloud의 엔터프라이즈용입니다.\n>\n> 엔터프라이즈가 GHE가 아닌 Copilot Business라면, 이전에 공유된 초기 액세스 문서 링크를 참조하세요.\n\n이 엔드포인트는 클래식 personal access tokens을 사용하는 엔터프라이즈 팀의 엔터프라이즈에 인증된 구성원만 사용할 수 있으며, 필요한 권한은 `read:enterprise` [scope](/ko/apps/oauth-apps/building-oauth-apps/scopes-for-oauth-apps)(`GET` API용) 및 `admin:enterprise`(기타 API용)입니다.\n\n이러한 엔드포인트는 fine-grained personal access tokens 또는 GitHub 앱 액세스 토큰과는 호환되지 않습니다.\n\nGitHub는 팀 `name`에서 엔터프라이즈 팀의 `slug`를 생성하고 `ent:` 접두사를 추가합니다.\n\n> \\[!NOTE]\n> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.\n\n## Get organization assignments\n\n```\nGET /enterprises/{enterprise}/teams/{enterprise-team}/organizations\n```\n\nGet all organizations assigned to an enterprise team\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`enterprise`** (string) (required)\n  The slug version of the enterprise name.\n\n* **`enterprise-team`** (string) (required)\n  The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.\n\n* **`per_page`** (integer)\n  The number of results per page (max 100). For more information, see \"Using pagination in the REST API.\"\n  Default: `30`\n\n* **`page`** (integer)\n  The page number of the results to fetch. For more information, see \"Using pagination in the REST API.\"\n  Default: `1`\n\n### HTTP response status codes\n\n* **200** - An array of organizations the team is assigned to\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations\n```\n\n**Response schema (Status: 200):**\n\nArray of `Organization Simple`:\n\n* `login`: required, string\n* `id`: required, integer\n* `node_id`: required, string\n* `url`: required, string, format: uri\n* `repos_url`: required, string, format: uri\n* `events_url`: required, string, format: uri\n* `hooks_url`: required, string\n* `issues_url`: required, string\n* `members_url`: required, string\n* `public_members_url`: required, string\n* `avatar_url`: required, string\n* `description`: required, string or null\n\n## Add organization assignments\n\n```\nPOST /enterprises/{enterprise}/teams/{enterprise-team}/organizations/add\n```\n\nAssign an enterprise team to multiple organizations.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`enterprise`** (string) (required)\n  The slug version of the enterprise name.\n\n* **`enterprise-team`** (string) (required)\n  The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.\n\n#### Body parameters\n\n* **`organization_slugs`** (array of strings) (required)\n  Organization slug to assign the team to.\n\n### HTTP response status codes\n\n* **200** - Successfully assigned the enterprise team to organizations.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X POST \\\n  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations/add \\\n  -d '{\n  \"organization_slugs\": [\n    \"github\"\n  ]\n}'\n```\n\n**Response schema (Status: 200):**\n\nSame response schema as [Get organization assignments](#get-organization-assignments).\n\n## Remove organization assignments\n\n```\nPOST /enterprises/{enterprise}/teams/{enterprise-team}/organizations/remove\n```\n\nUnassign an enterprise team from multiple organizations.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`enterprise`** (string) (required)\n  The slug version of the enterprise name.\n\n* **`enterprise-team`** (string) (required)\n  The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.\n\n#### Body parameters\n\n* **`organization_slugs`** (array of strings) (required)\n  Organization slug to unassign the team from.\n\n### HTTP response status codes\n\n* **204** - Successfully unassigned the enterprise team from organizations.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X POST \\\n  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations/remove \\\n  -d '{\n  \"organization_slugs\": [\n    \"github\"\n  ]\n}'\n```\n\n**Response schema (Status: 204):**\n\n## Get organization assignment\n\n```\nGET /enterprises/{enterprise}/teams/{enterprise-team}/organizations/{org}\n```\n\nCheck if an enterprise team is assigned to an organization\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`enterprise`** (string) (required)\n  The slug version of the enterprise name.\n\n* **`enterprise-team`** (string) (required)\n  The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.\n\n* **`org`** (string) (required)\n  The organization name. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **200** - The team is assigned to the organization\n\n* **404** - The team is not assigned to the organization\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X GET \\\n  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations/ORG\n```\n\n**Response schema (Status: 200):**\n\n* `login`: required, string\n* `id`: required, integer\n* `node_id`: required, string\n* `url`: required, string, format: uri\n* `repos_url`: required, string, format: uri\n* `events_url`: required, string, format: uri\n* `hooks_url`: required, string\n* `issues_url`: required, string\n* `members_url`: required, string\n* `public_members_url`: required, string\n* `avatar_url`: required, string\n* `description`: required, string or null\n\n## Add an organization assignment\n\n```\nPUT /enterprises/{enterprise}/teams/{enterprise-team}/organizations/{org}\n```\n\nAssign an enterprise team to an organization.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`enterprise`** (string) (required)\n  The slug version of the enterprise name.\n\n* **`enterprise-team`** (string) (required)\n  The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.\n\n* **`org`** (string) (required)\n  The organization name. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **201** - Successfully assigned the enterprise team to the organization.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X PUT \\\n  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations/ORG\n```\n\n**Response schema (Status: 201):**\n\nSame response schema as [Get organization assignment](#get-organization-assignment).\n\n## Delete an organization assignment\n\n```\nDELETE /enterprises/{enterprise}/teams/{enterprise-team}/organizations/{org}\n```\n\nUnassign an enterprise team from an organization.\n\n### Parameters\n\n#### Headers\n\n* **`accept`** (string)\n  Setting to `application/vnd.github+json` is recommended.\n\n#### Path and query parameters\n\n* **`enterprise`** (string) (required)\n  The slug version of the enterprise name.\n\n* **`enterprise-team`** (string) (required)\n  The slug version of the enterprise team name. You can also substitute this value with the enterprise team id.\n\n* **`org`** (string) (required)\n  The organization name. The name is not case sensitive.\n\n### HTTP response status codes\n\n* **204** - Successfully unassigned the enterprise team from the organization.\n\n### Code examples\n\n#### Example\n\n**Request:**\n\n```curl\ncurl -L \\\n  -X DELETE \\\n  https://api.github.com/enterprises/ENTERPRISE/teams/ENTERPRISE-TEAM/organizations/ORG\n```\n\n**Response schema (Status: 204):**"}