Endpoints to manage GitHub Enterprise Teams.
5 endpoints tagged enterprise-teams, each listing its
parameters and possible responses. Search or scroll the index below to
jump to a specific endpoint.
No endpoints match your search.
GET /enterprises/{enterprise}/teams
List all teams in the enterprise for the authenticated user
| Name | In | Required | Description |
|---|---|---|---|
enterprise | path | yes | The slug version of the enterprise name. |
per_page | query | no | The number of results per page (max 100). For more information, see "Using pagination in the REST API." |
page | query | no | The page number of the results to fetch. For more information, see "Using pagination in the REST API." |
| Status | Description | Has JSON body |
|---|---|---|
| 200 | Response | yes |
| 403 | Forbidden | yes |
POST /enterprises/{enterprise}/teams
To create an enterprise team, the authenticated user must be an owner of the enterprise.
| Name | In | Required | Description |
|---|---|---|---|
enterprise | path | yes | The slug version of the enterprise name. |
| Status | Description | Has JSON body |
|---|---|---|
| 201 | Response | yes |
GET /enterprises/{enterprise}/teams/{team_slug}
Gets a team using the team's slug. To create the slug, GitHub replaces special characters in the name string, changes all words to lowercase, and replaces spaces with a - separator and adds the "ent:" prefix. For example, "My TEam Näme" would become ent:my-team-name.
| Name | In | Required | Description |
|---|---|---|---|
enterprise | path | yes | The slug version of the enterprise name. |
team_slug | path | yes | The slug of the team name. |
| Status | Description | Has JSON body |
|---|---|---|
| 200 | Response | yes |
| 403 | Forbidden | yes |
PATCH /enterprises/{enterprise}/teams/{team_slug}
To edit a team, the authenticated user must be an enterprise owner.
| Name | In | Required | Description |
|---|---|---|---|
enterprise | path | yes | The slug version of the enterprise name. |
team_slug | path | yes | The slug of the team name. |
| Status | Description | Has JSON body |
|---|---|---|
| 200 | Response | yes |
| 403 | Forbidden | yes |
DELETE /enterprises/{enterprise}/teams/{team_slug}
To delete an enterprise team, the authenticated user must be an enterprise owner.
| Name | In | Required | Description |
|---|---|---|---|
enterprise | path | yes | The slug version of the enterprise name. |
team_slug | path | yes | The slug of the team name. |
| Status | Description | Has JSON body |
|---|---|---|
| 204 | Response | no |
| 403 | Forbidden | yes |