added

Registrant Group Management API Endpoints

Registrant Groups

Introduced two new endpoints for managing registrant group assignments via the API:

  • POST /api/v1/registrant/{registrant_id}/group/{group_id}
    Adds a registrant to an existing group, following the same business rules as the UI.
    Automatically updates:

    • group_id for the registrant
    • All associated line items and hotel records
    • Transaction ownership and balances
    • Returns the full updated registrant object.
  • DELETE /api/v1/registrant/{registrant_id}/group
    Removes a registrant from their current group.
    On removal:

    • The registrant becomes their own group primary
    • Transactions are restored to original owners
    • Financial totals are recalculated
    • Returns the updated registrant object reflecting the changes.

Both endpoints include robust validation and error handling for:

  • Invalid or missing parameters
  • Registrant or group not found
  • Violations of business rules (e.g. cross-event group assignments, invalid statuses)
  • Authorization and access checks

API documentation includes detailed response schemas, usage examples, and error scenarios.