Skip to main content

Remove Team Member

Remove a user from a team. The user will lose access to all team resources.

Endpoint

DELETE /api/teams/{teamId}/users/{userId}

Headers

Authorization
string
required
Bearer token for authentication

Path Parameters

teamId
string
required
Team UUID
userId
string
required
User UUID to remove

Response

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

Example Request

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

What Happens When Removed

When a user is removed from a team:
  • They immediately lose access to all team websites
  • They can no longer view team analytics
  • They cannot create or edit team resources
  • Their user account remains active
  • Personal websites (if any) are unaffected

Error Responses

400
error
Bad Request - User does not exist on this team
401
error
Unauthorized - You must be the owner/manager of this team
404
error
Not Found - Team or user does not exist

Permissions

You can remove a team member if:
  • You are a team owner or manager
  • You are removing yourself from the team (any member can leave)
Removing the last owner/manager from a team may make the team unmanageable. Ensure there is at least one manager remaining.
Users can be re-added to the team later using the Add Team Member endpoint.

Build docs developers (and LLMs) love