# GitHub Enterprise Teams API

**Canonical:** https://apis.io/apis/github-enterprise/github-enterprise-teams-api/  
**Provider:** GitHub Enterprise — https://apis.io/providers/github-enterprise/  
**Base URL:** https://api.github.com  
**Documentation:** https://docs.github.com/en/enterprise-cloud@latest/rest

GitHub Enterprise Teams API is one of 58 APIs that [GitHub Enterprise](https://apis.io/providers/github-enterprise/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 8 JSON Schema definitions. Tagged areas include Team. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, rate-limit docs, authentication docs, and 8 JSON Schemas.

Interact with GitHub Teams.

## Operations (42)

| Method | Path | Summary |
|---|---|---|
| GET | `/orgs/{org}/external-group/{group_id}` | Get an external group |
| GET | `/orgs/{org}/external-groups` | List external groups available to an organization |
| GET | `/orgs/{org}/team-sync/groups` | List IdP groups for an organization |
| GET | `/orgs/{org}/teams` | List teams |
| POST | `/orgs/{org}/teams` | Create a team |
| GET | `/orgs/{org}/teams/{team_slug}` | Get a team by name |
| PATCH | `/orgs/{org}/teams/{team_slug}` | Update a team |
| DELETE | `/orgs/{org}/teams/{team_slug}` | Delete a team |
| GET | `/orgs/{org}/teams/{team_slug}/external-groups` | List a connection between an external group and a team |
| PATCH | `/orgs/{org}/teams/{team_slug}/external-groups` | Update the connection between an external group and a team |
| DELETE | `/orgs/{org}/teams/{team_slug}/external-groups` | Remove the connection between an external group and a team |
| GET | `/orgs/{org}/teams/{team_slug}/invitations` | List pending team invitations |
| GET | `/orgs/{org}/teams/{team_slug}/members` | List team members |
| GET | `/orgs/{org}/teams/{team_slug}/memberships/{username}` | Get team membership for a user |
| PUT | `/orgs/{org}/teams/{team_slug}/memberships/{username}` | Add or update team membership for a user |
| DELETE | `/orgs/{org}/teams/{team_slug}/memberships/{username}` | Remove team membership for a user |
| GET | `/orgs/{org}/teams/{team_slug}/repos` | List team repositories |
| GET | `/orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}` | Check team permissions for a repository |
| PUT | `/orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}` | Add or update team repository permissions |
| DELETE | `/orgs/{org}/teams/{team_slug}/repos/{owner}/{repo}` | Remove a repository from a team |
| GET | `/orgs/{org}/teams/{team_slug}/team-sync/group-mappings` | List IdP groups for a team |
| PATCH | `/orgs/{org}/teams/{team_slug}/team-sync/group-mappings` | Create or update IdP group connections |
| GET | `/orgs/{org}/teams/{team_slug}/teams` | List child teams |
| GET | `/teams/{team_id}` | Get a team (Legacy) |
| PATCH | `/teams/{team_id}` | Update a team (Legacy) |
| DELETE | `/teams/{team_id}` | Delete a team (Legacy) |
| GET | `/teams/{team_id}/invitations` | List pending team invitations (Legacy) |
| GET | `/teams/{team_id}/members` | List team members (Legacy) |
| GET | `/teams/{team_id}/members/{username}` | Get team member (Legacy) |
| PUT | `/teams/{team_id}/members/{username}` | Add team member (Legacy) |
| DELETE | `/teams/{team_id}/members/{username}` | Remove team member (Legacy) |
| GET | `/teams/{team_id}/memberships/{username}` | Get team membership for a user (Legacy) |
| PUT | `/teams/{team_id}/memberships/{username}` | Add or update team membership for a user (Legacy) |
| DELETE | `/teams/{team_id}/memberships/{username}` | Remove team membership for a user (Legacy) |
| GET | `/teams/{team_id}/repos` | List team repositories (Legacy) |
| GET | `/teams/{team_id}/repos/{owner}/{repo}` | Check team permissions for a repository (Legacy) |
| PUT | `/teams/{team_id}/repos/{owner}/{repo}` | Add or update team repository permissions (Legacy) |
| DELETE | `/teams/{team_id}/repos/{owner}/{repo}` | Remove a repository from a team (Legacy) |
| GET | `/teams/{team_id}/team-sync/group-mappings` | List IdP groups for a team (Legacy) |
| PATCH | `/teams/{team_id}/team-sync/group-mappings` | Create or update IdP group connections (Legacy) |
| GET | `/teams/{team_id}/teams` | List child teams (Legacy) |
| GET | `/user/teams` | List teams for the authenticated user |

## Machine-readable artifacts (16)

- **OpenAPI** — https://artifacts.apis.io/github-enterprise/openapi/github-enterprise-teams-api-openapi.yml
- **Documentation** — https://docs.github.com/en/enterprise-cloud@latest/rest
- **RateLimits** — https://docs.github.com/en/enterprise-cloud@latest/rest/using-the-rest-api/rate-limits-for-the-rest-api
- **JSONSchema** — https://artifacts.apis.io/github-enterprise/json-schema/github-enterprise-repository-schema.json
- **JSONSchema** — https://artifacts.apis.io/github-enterprise/json-schema/github-enterprise-full-repository-schema.json
- **JSONSchema** — https://artifacts.apis.io/github-enterprise/json-schema/github-enterprise-app-permissions-schema.json
- **JSONSchema** — https://artifacts.apis.io/github-enterprise/json-schema/github-enterprise-team-repository-schema.json
- **JSONSchema** — https://artifacts.apis.io/github-enterprise/json-schema/github-enterprise-organization-full-schema.json
- **JSONSchema** — https://artifacts.apis.io/github-enterprise/json-schema/github-enterprise-minimal-repository-schema.json
- **Authentication** — https://docs.github.com/en/enterprise-cloud@latest/rest/overview/authenticating-to-the-rest-api
- **Documentation** — https://docs.github.com/en/enterprise-cloud@latest/graphql
- **GraphQL** — https://artifacts.apis.io/github-enterprise/graphql/github-enterprise-graphql.md
- **Documentation** — https://docs.github.com/en/enterprise-server@latest/rest
- **Documentation** — https://docs.github.com/en/enterprise-server@latest/graphql
- **JSONSchema** — https://artifacts.apis.io/github-enterprise/json-schema/github-enterprise-organization-schema.json
- **JSONSchema** — https://artifacts.apis.io/github-enterprise/json-schema/github-enterprise-pull-request-schema.json

## Other GitHub Enterprise APIs (12)

- [GitHub Enterprise Cloud GraphQL API](https://apis.io/apis/github-enterprise/github-enterprise-graphql-api/)
- [GitHub MCP Server](https://apis.io/apis/github-enterprise/github-mcp-server/)
- [GitHub Enterprise Actions API](https://apis.io/apis/github-enterprise/github-enterprise-actions-api/)
- [GitHub Enterprise Code Scanning API](https://apis.io/apis/github-enterprise/github-enterprise-code-scanning-api/)
- [GitHub Enterprise Admin API](https://apis.io/apis/github-enterprise/github-enterprise-enterprise-admin-api/)
- [GitHub Enterprise Issues API](https://apis.io/apis/github-enterprise/github-enterprise-issues-api/)
- [GitHub Enterprise SCIM API](https://apis.io/apis/github-enterprise/github-enterprise-scim-api/)
- [GitHub Enterprise Users API](https://apis.io/apis/github-enterprise/github-enterprise-users-api/)
- [GitHub Enterprise Activity API](https://apis.io/apis/github-enterprise/github-enterprise-activity-api/)
- [GitHub Enterprise Agent Automations API](https://apis.io/apis/github-enterprise/github-enterprise-agent-automations-api/)
- [GitHub Enterprise Agent Merge API](https://apis.io/apis/github-enterprise/github-enterprise-agent-merge-api/)
- [GitHub Enterprise Agent Tasks API](https://apis.io/apis/github-enterprise/github-enterprise-agent-tasks-api/)

## Tags

Team

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/github-enterprise/github-enterprise-teams-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/github-enterprise/.