Managing Participant Groups on Flows Using API

Participant groups represent logical groupings of participants within a flow and can be used with any group types supported in WISEflow. With the new endpoints, client systems can now create, update, and delete participant groups directly via the API.

What is a Participant Group?

A participant group links one or more participants together on a specific flow. Groups define how submissions are handed in and how grading is applied.

The Participant Groups API works with all group types supported in WISEflow:

• Group submission
• Individual submissions
• Group with shared submission and individual grading

Participant groups are always flow-specific and exist only within the context of the flow where they are created.

Supported Operations

The new endpoints allow you to create, update, and delete participant groups:

• GET /flows/{flowId}/participant-groups
• POST /flows/{flowId}/participant-groups
• PUT /flows/{flowId}/participant-groups/{groupId}
• DELETE /flows/{flowId}/participant-groups/{groupId}

This enables full lifecycle management of participant groups from external systems.

Typical Use Cases

• Synchronising group structures from a Student Information System (SIS)
• Automatically creating groups when setting up flows with group‑based assessments
• Maintaining group membership when students are added, removed, or reorganised
• Supporting different submission and grading models programmatically