TeamService

Manages organizational teams (departments, divisions). Teams are structural units within an organization and can be used for campaign audience targeting.

Methods

Method	Description
CreateTeam	Create a new team
GetTeam	Get a team by ID
ListTeams	List teams for the organization
UpdateTeam	Update a team
DeleteTeam	Delete a team
AddTeamMembers	Add members to a team
RemoveTeamMembers	Remove members from a team
ListTeamMembers	List members of a team

CreateTeam

Authorization: Requires PERMISSION_TEAMS_WRITE (own teams) or PERMISSION_TEAMS_ALL_WRITE permission

Request: CreateTeamRequest

Field	Type	Description
name	string	Team name. Max 200 characters.
description	string	Team description. Max 1000 characters.

Response: CreateTeamResponse

Field	Type	Description
team	Team	The created team.

GetTeam

Authorization: Requires PERMISSION_TEAMS_ALL_READ or PERMISSION_TEAMS_ALL_WRITE permission

Request: GetTeamRequest

Field	Type	Description
id	string	Team ID.

Response: GetTeamResponse

Field	Type	Description
team	Team	The team.

ListTeams

Authorization: Requires PERMISSION_TEAMS_ALL_READ or PERMISSION_TEAMS_ALL_WRITE permission

Request: ListTeamsRequest

Field	Type	Description
pagination	Pagination	Pagination parameters.

Response: ListTeamsResponse

Field	Type	Description
teams	Team[]	List of teams.
pagination	PaginationMeta	Pagination metadata.

UpdateTeam

Authorization: Requires PERMISSION_TEAMS_WRITE (own teams) or PERMISSION_TEAMS_ALL_WRITE permission

Request: UpdateTeamRequest

Field	Type	Description
id	string	Team ID.
name	string	Updated name.
description	string	Updated description.

Response: UpdateTeamResponse

Field	Type	Description
team	Team	The updated team.

DeleteTeam

Authorization: Requires PERMISSION_TEAMS_WRITE (own teams) or PERMISSION_TEAMS_ALL_WRITE permission

Request: DeleteTeamRequest

Field	Type	Description
id	string	Team ID to delete.

Response: DeleteTeamResponse

Empty response on success.

AddTeamMembers

Authorization: Requires PERMISSION_TEAMS_WRITE (own teams) or PERMISSION_TEAMS_ALL_WRITE permission

Request: AddTeamMembersRequest

Field	Type	Description
team_id	string	Team ID.
user_ids	string[]	User IDs to add. Max 1000 per request.

Response: AddTeamMembersResponse

Field	Type	Description
added_count	int32	Number of members added.

RemoveTeamMembers

Authorization: Requires PERMISSION_TEAMS_WRITE (own teams) or PERMISSION_TEAMS_ALL_WRITE permission

Request: RemoveTeamMembersRequest

Field	Type	Description
team_id	string	Team ID.
user_ids	string[]	User IDs to remove.

Response: RemoveTeamMembersResponse

Field	Type	Description
removed_count	int32	Number of members removed.

ListTeamMembers

Authorization: Requires PERMISSION_TEAMS_ALL_READ or PERMISSION_TEAMS_ALL_WRITE permission

Request: ListTeamMembersRequest

Field	Type	Description
team_id	string	Team ID.
pagination	Pagination	Pagination parameters.

Response: ListTeamMembersResponse

Field	Type	Description
users	User[]	List of team members.
pagination	PaginationMeta	Pagination metadata.

Team Message

Field	Type	Description
id	string	Unique identifier.
name	string	Team name.
description	string	Team description.
member_count	int32	Number of members.
created_at	Timestamp	Creation timestamp.
updated_at	Timestamp	Last update timestamp.