Sample - GitHub REST API
DELETE/orgs/{org}/teams/{team_slug}

Delete a team

To delete a team, the authenticated user must be an organization owner or team maintainer.

If you are an organization owner, deleting a parent team will delete all of its child teams as well.

[!NOTE] You can also specify a team by org_id and team_id using the route DELETE /organizations/{org_id}/team/{team_id}.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
orgstringrequired
The organization name. The name is not case sensitive.
team_slugstringrequired
The slug of the team name.

2 status codes
204Response
422Unprocessable entity if you attempt to modify an enterprise team at the organization level.

Error handling

A 422 is returned: Unprocessable entity if you attempt to modify an enterprise team at the organization level.