DevelopersAPI referenceAuth & accountsTeams
Delete a team
Team workspaces only; team lead or org.teams.manage. Soft delete. The workspace's DEFAULT team cannot be deleted and answers 409 with `code: default_team`. Everyone who joins the workspace belongs to it, so deleting it dropped every roster row, left the team's content unreachable in the tools, and was then rebuilt empty by the next join — carrying only the owner and that joiner, leaving everyone else on no team until the service next converged. An admin tightening access wants to remove members, which is a different call. The default team goes when the workspace goes.
View as MarkdownAuthorization
bearer AuthorizationBearer <token>
In: header
Path Parameters
id*string
tid*string
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/v1/workspaces/string/teams/string"{ "message": "string"}