Manual
CLI
API
Log in Get started free

Delete a team

Deletes a team. Its members keep their place in the organisation.

Deletes a team. Its members keep their place in the organisation.

HTTP
DELETE /teams/{teamId}

Access: Session token only. API keys get 403 with insufficient_scope.

Role: Organisation owner or admin, or owner or admin of the team.

Path parameters #

ParameterDescription
teamIdThe id of the team.

Response 204 #

The team is deleted. There is no body.

Errors #

StatuserrorWhen
401unauthenticatedThe token is missing or not valid.
404not_foundThe team does not exist in your organisation, or an id is not a UUID.
403forbiddenYou may not change this team.
429rate_limitedToo many requests, see Rate limiting.

See Errors for the error format.