Remove member
DELETE /teams/{teamId}/members/{userId}
Removes a member from the team. Requires the owner role.
teams:delete · Team permission:members.remove · Rate limit: default (120 / 60s)owner. Both fail with 400 BAD_REQUEST.Beyond the key's own scope, the person who created the key must hold members.remove on the team, and the same containment rules apply as in the Hub: you cannot remove somebody whose role is not smaller than yours, and the team owner cannot be removed by anyone. One Admin cannot remove another, because Admin and Owner hold the same permissions and neither is below the other — a key created by the account owner is the exception and can remove anybody.
What Happens to Their Work
Removing a member removes their access, not their work. Dashboards, clients, goals, connections, Google Sheets queries and Looker Studio query configs all stay with the team, and their scheduled refreshes keep running.
If you only want to free their seat, un-assign the seat instead of removing them — they keep read access and nothing they built is affected. See Managing members.
Path parameters
Request
curl -X DELETE https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/members/0190f8a4-5e6f-7a8b-9c0d-1e2f3a4b5c6d \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Response
{
"success": true,
"data": { "removed": true }
}
{
"success": false,
"error": { "code": "BAD_REQUEST", "message": "Cannot remove the last owner. Assign another owner first." }
}
{
"success": false,
"error": { "code": "PAYMENT_REQUIRED", "message": "Your team's plan has been cancelled. Please reactivate your subscription to continue." }
}
{
"success": false,
"error": { "code": "FORBIDDEN", "message": "You do not have permission to perform this action" }
}
The member holds permissions the key's holder does not. An equal role is refused too.
{
"success": false,
"error": { "code": "CANNOT_ACT_ON_MEMBER", "message": "This member holds permissions you do not have, so you cannot change or remove them. Ask an Admin." }
}
{
"success": false,
"error": { "code": "CANNOT_ACT_ON_OWNER", "message": "The team owner's role cannot be changed and they cannot be removed from the team." }
}
The key holder's role allows this, but they have no seat in the team.
{
"success": false,
"error": { "code": "SEAT_REQUIRED", "message": "You do not have a seat in this team, so you can view but not change anything. Ask an Admin for a seat." }
}
Returned when the team does not exist, or the user is not a member of it.
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "Member not found in team" }
}