wxc_sdk.team_memberships package

class wxc_sdk.team_memberships.TeamMembership(*, id: Optional[str] = None, teamId: Optional[str] = None, personId: Optional[str] = None, personEmail: Optional[str] = None, personDisplayName: Optional[str] = None, personOrgId: Optional[str] = None, isModerator: Optional[bool] = None, created: Optional[datetime] = None)[source]

Bases: ApiModel

Create a new model by parsing and validating input data from keyword arguments.

Raises ValidationError if the input data cannot be parsed to form a valid model.

id: Optional[str]

A unique identifier for the team membership.

team_id: Optional[str]

The team ID.

person_id: Optional[str]

The person ID.

person_email: Optional[str]

The email address of the person.

person_display_name: Optional[str]

The display name of the person.

person_org_id: Optional[str]

The organization ID of the person.

is_moderator: Optional[bool]

Whether or not the participant is a team moderator.

created: Optional[datetime]

The date and time when the team membership was created.

class wxc_sdk.team_memberships.TeamMembershipsApi(*, session: RestSession, base: Optional[str] = None)[source]

Bases: ApiChild

Team Memberships represent a person’s relationship to a team. Use this API to list members of any team that you’re in or create memberships to invite someone to a team. Team memberships can also be updated to make someone a moderator or deleted to remove them from the team. Just like in the Webex app, you must be a member of the team in order to list its memberships or invite people.

list_memberships(team_id: str, **params) → Generator[TeamMembership, None, None][source]

Lists all team memberships for a given team, specified by the teamId query parameter. Use query parameters to filter the response.

Parameters

team_id (str) – List memberships for a team, by ID.

create_membership(team_id: str, person_id: Optional[str] = None, person_email: Optional[str] = None, is_moderator: Optional[bool] = None) → TeamMembership[source]

Add someone to a team by Person ID or email address, optionally making them a moderator.

Parameters

  • team_id (str) – The team ID.

  • person_id (str) – The person ID.

  • person_email (str) – The email address of the person.

  • is_moderator (bool) – Whether or not the participant is a team moderator.

membership_details(membership_id: str) → TeamMembership[source]

Shows details for a team membership, by ID. Specify the team membership ID in the membershipId URI parameter.

Parameters

membership_id (str) – The unique identifier for the team membership.

update_membership(membership_id: str, is_moderator: bool) → TeamMembership[source]

Updates a team membership, by ID. Specify the team membership ID in the membershipId URI parameter.

Parameters

  • membership_id (str) – The unique identifier for the team membership.

  • is_moderator (bool) – Whether or not the participant is a team moderator.

delete_membership(membership_id: str)[source]

Deletes a team membership, by ID. Specify the team membership ID in the membershipId URI parameter. The team membership for the last moderator of a team may not be deleted; promote another user to team moderator first.

Parameters

membership_id (str) – The unique identifier for the team membership.

base = 'team/memberships'
session: RestSession

REST session