Skip to main content

​
Delete Team

Permanently delete a team. This will remove all team memberships but will not delete websites owned by the team.
This action is irreversible. All team memberships will be removed. Consider transferring team websites to individual users before deleting the team.

​
Endpoint

DELETE /api/teams/{teamId}

​
Headers

​
Authorization
string
required
Bearer token for authentication

​
Path Parameters

​
teamId
string
required
Team UUID to delete

​
Response

Returns a 200 OK status with an empty response body on successful deletion.

​
Example Request

curl -X DELETE https://your-umami-instance.com/api/teams/660e8400-e29b-41d4-a716-446655440001 \
  -H "Authorization: Bearer YOUR_TOKEN"

​
Error Responses

​
401
error
Unauthorized - You must be the owner/manager of this team
​
404
error
Not Found - Team does not exist

​
What Happens When Deleted

When a team is deleted:
  • All team memberships are removed
  • Team users lose access to team resources
  • Team websites may need to be transferred or will become inaccessible

​
Permissions

Only team owners and managers can delete teams.
Before deleting a team, ensure that any team-owned websites are transferred to individual users or that you’re prepared to lose access to those websites.

Build docs developers (and LLMs) love

Get started for freeTalk to us