Teams
Update member role
Change a team member's role.
PUT /teams/{teamId}/members/{userId}/role
Changes a member's role on the team. Requires the owner role.
Authentication: Bearer token · Role: owner · Permission:
teams:write · Rate limit: default (120 / 60s)A team must always have at least one
owner. Demoting the last remaining owner fails with 400 BAD_REQUEST — promote another member to owner first.Path parameters
teamId
string · uuid v7 required
The ID of the team.
userId
string · uuid v7 required
The ID of the member to update, from list members.
Request body
role
string required
The new role. One of
viewer, editor, owner.{ "role": "editor" }
Request
curl -X PUT https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/members/0190f8a4-5e6f-7a8b-9c0d-1e2f3a4b5c6d/role \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{ "role": "editor" }'
Response
{
"success": true,
"data": { "updated": true }
}
{
"success": false,
"error": { "code": "BAD_REQUEST", "message": "Cannot demote 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" }
}
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" }
}