Groups

The Groups API enables you to create and manage groups (Team Views) within Avaya Infinity™. Groups are identified by a unique 26-character group ID prefixed 007.

For managing group membership, see the Group Users API Reference.

Endpoints

List All Groups

GET /groups

Retrieve a paginated list of all active groups for the account. Supports filtering by date range using updatedSince and updatedUntil to retrieve groups that have changed within a specific window. Groups are considered updated when their properties change or when members are added, removed, or modified.

View API Reference →

Create a Group

POST /groups

Create a new group with optional initial members. If no members are specified, the authenticated user is automatically added as the first member.

View API Reference →

Get a Group

GET /groups/{groupId}

Retrieve a specific group by ID, including its full list of members. Use the includeInDashboard query parameter to filter the returned members by their team dashboard visibility setting.

View API Reference →

Update a Group

PATCH /groups/{groupId}

Update a group's properties and/or membership. At least one property must be provided. When updating members, the supplied list replaces all existing members.

View API Reference →

Getting Started

Use the List All Groups endpoint to discover existing groups and their IDs. To set up a new group, call Create a Group with a name and optional initial members. Use Update a Group to modify properties or replace the full member list. To add members incrementally without affecting existing membership, use the Group Users API.