Teams

Remove a team member

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

Removes a user's membership from the specified team, subject to team role and ownership restrictions.

Try it

Name	Type	Description
Authorizationrequired	string	Token returned by POST /api/auth/login, or an API key (`umami_…`) created under Settings → API keys (self-hosted only). `Bearer <token>`.

Name	Type	Description
teamIdrequired	string	ID of the associated team.
userIdrequired	string	ID of the associated user.

200The operation completed successfully.

Name	Type	Description
okrequired	any	Whether the operation succeeded.

200 example

{
  "ok": {}
}

400Bad request.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

400 example

{
  "error": {
    "code": "bad-request",
    "message": "Bad request.",
    "status": 400
  }
}

401Unauthorized.

Name	Type	Description
errorrequired	object	Error details returned when the operation fails.

401 example

{
  "error": {
    "code": "unauthorized",
    "message": "Unauthorized.",
    "status": 401
  }
}

cURL

curl -X DELETE 'https://api.example.com/api/teams/{teamId}/users/{userId}' \
  -H 'Authorization: Bearer <token>'