Teams
Assign or unassign a seat
Give a team member a seat, or take one back.
PUT /teams/{teamId}/members/{userId}/seat
Gives a member a seat, or takes theirs back.
Authentication: Bearer token · Role: owner · Permission:
teams:write · Team permission:members.set_seat · Rate limit: default (120 / 60s)A seat is the licence to change things. A member without one can still see everything the team has and change none of it, whatever their role says. Members are unlimited; seats are what your plan caps.
A seat is not a rank. Unlike changing a role, this is not bounded by the containment rules — anyone holding
members.set_seat can take back anyone's seat, the account owner's included. The owner keeps billing and seat control without a seat of their own, so a team cannot lock itself out of its own plan.The one rule that still applies: you cannot change your own seat. That stops the last free seat being taken by whoever happens to be looking.Path parameters
teamId
string · uuid v7 required
The ID of the team.
userId
string · uuid v7 required
The ID of the member, from list members.
Request body
seat
string required
standard to give this member a seat, none to take it back.{ "seat": "standard" }
Request
curl -X PUT https://api.twominutereports.com/v1/teams/0190f8b0-1a2b-7c3d-8e4f-5a6b7c8d9e0f/members/0190f8a4-5e6f-7a8b-9c0d-1e2f3a4b5c6d/seat \
-H "Authorization: Bearer tmrc_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{ "seat": "standard" }'
Response
{
"success": true,
"data": {
"userId": "0190f8a4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"seat": "standard"
}
}
Every seat on the plan is assigned. Take one back from another member, or add seats to the plan.
{
"success": false,
"error": { "code": "SEAT_LIMIT_REACHED", "message": "All 4 seats on this team's plan are assigned. Un-assign someone else's seat, or add seats to the plan." }
}
{
"success": false,
"error": { "code": "CANNOT_ACT_ON_SELF", "message": "You cannot change your own role or seat. Ask another Admin to do it." }
}
{
"success": false,
"error": { "code": "NOT_FOUND", "message": "Member not found in team" }
}
Related
- Seats — what a seat buys, and who needs one
- List members — every member's role and seat
- Update member role