MembershipsManager

July 28, 2025 ยท View on GitHub

List user's groups

Retrieves all the groups for a user. Only members of this group or users with admin-level permissions will be able to use this API.

This operation is performed by calling function getUserMemberships.

See the endpoint docs at API Reference.

try await client.memberships.getUserMemberships(userId: user.id)

Arguments

  • userId String
    • The ID of the user. Example: "12345"
  • queryParams GetUserMembershipsQueryParams
    • Query parameters of getUserMemberships method
  • headers GetUserMembershipsHeaders
    • Headers of getUserMemberships method

Returns

This function returns a value of type GroupMemberships.

Returns a collection of membership objects. If there are no memberships, an empty collection will be returned.

List members of group

Retrieves all the members for a group. Only members of this group or users with admin-level permissions will be able to use this API.

This operation is performed by calling function getGroupMemberships.

See the endpoint docs at API Reference.

try await client.memberships.getGroupMemberships(groupId: group.id)

Arguments

  • groupId String
    • The ID of the group. Example: "57645"
  • queryParams GetGroupMembershipsQueryParams
    • Query parameters of getGroupMemberships method
  • headers GetGroupMembershipsHeaders
    • Headers of getGroupMemberships method

Returns

This function returns a value of type GroupMemberships.

Returns a collection of membership objects. If there are no memberships, an empty collection will be returned.

Add user to group

Creates a group membership. Only users with admin-level permissions will be able to use this API.

This operation is performed by calling function createGroupMembership.

See the endpoint docs at API Reference.

try await client.memberships.createGroupMembership(requestBody: CreateGroupMembershipRequestBody(user: CreateGroupMembershipRequestBodyUserField(id: user.id), group: CreateGroupMembershipRequestBodyGroupField(id: group.id)))

Arguments

  • requestBody CreateGroupMembershipRequestBody
    • Request body of createGroupMembership method
  • queryParams CreateGroupMembershipQueryParams
    • Query parameters of createGroupMembership method
  • headers CreateGroupMembershipHeaders
    • Headers of createGroupMembership method

Returns

This function returns a value of type GroupMembership.

Returns a new group membership object.

Get group membership

Retrieves a specific group membership. Only admins of this group or users with admin-level permissions will be able to use this API.

This operation is performed by calling function getGroupMembershipById.

See the endpoint docs at API Reference.

try await client.memberships.getGroupMembershipById(groupMembershipId: groupMembership.id!)

Arguments

  • groupMembershipId String
    • The ID of the group membership. Example: "434534"
  • queryParams GetGroupMembershipByIdQueryParams
    • Query parameters of getGroupMembershipById method
  • headers GetGroupMembershipByIdHeaders
    • Headers of getGroupMembershipById method

Returns

This function returns a value of type GroupMembership.

Returns the group membership object.

Update group membership

Updates a user's group membership. Only admins of this group or users with admin-level permissions will be able to use this API.

This operation is performed by calling function updateGroupMembershipById.

See the endpoint docs at API Reference.

try await client.memberships.updateGroupMembershipById(groupMembershipId: groupMembership.id!, requestBody: UpdateGroupMembershipByIdRequestBody(role: UpdateGroupMembershipByIdRequestBodyRoleField.admin))

Arguments

  • groupMembershipId String
    • The ID of the group membership. Example: "434534"
  • requestBody UpdateGroupMembershipByIdRequestBody
    • Request body of updateGroupMembershipById method
  • queryParams UpdateGroupMembershipByIdQueryParams
    • Query parameters of updateGroupMembershipById method
  • headers UpdateGroupMembershipByIdHeaders
    • Headers of updateGroupMembershipById method

Returns

This function returns a value of type GroupMembership.

Returns a new group membership object.

Remove user from group

Deletes a specific group membership. Only admins of this group or users with admin-level permissions will be able to use this API.

This operation is performed by calling function deleteGroupMembershipById.

See the endpoint docs at API Reference.

try await client.memberships.deleteGroupMembershipById(groupMembershipId: groupMembership.id!)

Arguments

  • groupMembershipId String
    • The ID of the group membership. Example: "434534"
  • headers DeleteGroupMembershipByIdHeaders
    • Headers of deleteGroupMembershipById method

Returns

This function returns a value of type ``.

A blank response is returned if the membership was successfully deleted.