Update Team
PUT /teams/{team_id}
Update a team, and optionally re-attach everything on it in one call.
An omitted *_ids list LEAVES that attachment alone. A list that IS
present REPLACES it, so sending [] detaches every mailbox (or number, or
campaign) the team had. Omitting and sending an empty list are different
instructions and the second one is destructive - the handler diffs.
Authorizations
Parameters
Path Parameters
Team id (UUID).
Team id (UUID).
Header Parameters
Request Body required
Update a team. Mirrors teams.TeamUpdateDTO.
An omitted *_ids list LEAVES that attachment alone; a list that is
present REPLACES it (the handler diffs). Sending [] therefore detaches
everything of that kind, which is not the same instruction as omitting it.
object
One member in a team’s single-save membership list.
object
Member | manager
Responses
200
Successful Response
object
An open envelope for a single role, team, member or account record.
Open on purpose. The app’s own response models on this surface grow with
the product - RoleResponse gained rep_limits and manages_role_slugs,
TeamResponse gained channel counts and a campaign count - and a pinned
mirror would SILENTLY DROP whatever it had not caught up on. A dropped
permission in a role read is the worst possible kind of stale: it reads as
“they do not have it”.
object
object
Whether there are more pages
Items per page
Current page number (1-indexed)
Total number of items
422
Validation Error