Sign in
latestOpenAPI 3.1.02026-08-19270462702.4 KB

b92f75fd3b61

users

Set Active Team Endpoint

Switch the caller's active team.

Args: request: Target team payload. auth: Authenticated caller. service: User service.

Returns: Activated team.

Raises: HTTPException: If membership is revoked.

post/users/me/active-team

Request body

team_idstring uuid required

Response

Successful Response

idstring required
namestring required
owner_idstring required
payment_planstring required
router_enabledboolean
zero_data_retentionboolean
created_atstring required
updated_atstring required
member_countinteger nullable
current_user_role'owner' | 'billing' | 'admin' | 'editor' | 'viewer'

Team member roles with hierarchical permissions.

Wire DTO mirror of the ORM TeamRoleType enum. Used only for API request/response serialization; authorization decisions route through the ORM matrix (database_tables.permissions), never this enum.

capabilitiesobject nullable