Skip to content

Delete a team

DELETE
/orgs/{org}/teams/{team_slug}

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}.

API method documentation

org
required
string

The organization name. The name is not case sensitive.

team_slug
required
string

The slug of the team name.

Response

Unprocessable entity if you attempt to modify an enterprise team at the organization level.